home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 6: Level 6 / 17 Bit - Level 6 (1998)(Epic Marketing)[!].iso / quartz / q0867.dms / q0867.adf / TRAPDOOR.LZH / Docs / TrapDoor.Man < prev    next >
Text File  |  1992-11-07  |  170KB  |  4,900 lines
  1.  
  2.  
  3.      Page 1              TrapDoor's Fourth Manual               Page 1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                  TrapDoor®
  22.                           The Real Amiga Porridge
  23.                                Version 1.83
  24.                           Copyright (c) 1989-1992
  25.                    Maximilian Hantsch and Martin Laubach
  26.                             All rights reserved
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                          TrapDoor's Fourth Manual
  34.                         Thursday 05-Nov-92 10:23:27
  35.                           Copyright (c) 1989-1992
  36.                    Maximilian Hantsch and Martin Laubach
  37.                             All rights reserved
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                   This manual is intended to be read from
  48.                     front to back for more convenience.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.      Page 2              TrapDoor's Fourth Manual               Page 2
  66.  
  67.  
  68.   1. Introduction     
  69.  
  70.        This manual is a description of TrapDoor Amiga, explaining how
  71.      to set up the software in order to send and receive mail and
  72.      attached files.  Please refer to the documentation of other
  73.      Fidonet packages, for example oMMM, ConfMail, Foozle or even
  74.      better, the manual for TrapToss, for additional information on
  75.      file attaches, netmail routing, echomail and other topics you
  76.      are missing in here.  
  77.  
  78.        If you are new to Fidonet, we recommend to read TrapDoor's
  79.      Fidonet Manual (FidoNet.Man) first.  
  80.  
  81.        Please read the entire manual before using TrapDoor.  
  82.  
  83.        TrapDoor is a FidoNet-compatible front mailer for Amiga
  84.      systems. It transfers mail from/to other FidoNet-compatible
  85.      systems using WaZoo DietIfna and ZedZap technique as well as the
  86.      lowest common FidoNet protocol, FTS-0001 (Lotek). It also
  87.      features the latest EMSI (Electronic Mail Standard
  88.      Identification) handshake that allows two mailers to exchange
  89.      lots of interesting information at session startup, for example
  90.      AKA addresses.  
  91.  
  92.        TrapDoor handles both sending and receiving of files and mail
  93.      packets and is fairly easy to set up and use. It works well with
  94.      high speed modems, and includes all the features found on
  95.      standard FidoNet mailers, such as making and processing of
  96.      filerequests, password-protected mail sessions, automatic
  97.      nodelist lookup and much more.  
  98.  
  99.  
  100.  
  101.   2. Installation     
  102.  
  103.        TrapDoor is a CLI based application, it can't be run from
  104.      Workbench. It accepts a wide range of keywords that allow an
  105.      easy and accurate configuration.  
  106.  
  107.        Upon invocation, TrapDoor will try to find a file
  108.      "TrapDoor.cfg" in the current directory or in "MAIL:". This file
  109.      should contain your default configuration data for TrapDoor,
  110.      like your system's name, your nodenumber etc. (The option of
  111.      saving the configuration data within the program file, which was
  112.      available in earlier versions of TrapDoor, has been removed.)
  113.      You should set up at least the NAME, NODE, SYSOP, BOSS, and CALL
  114.      parameters.  
  115.  
  116.        If you wish to change any parameters from the settings in your
  117.      configuration file, just list the appropriate configuration
  118.      keywords on the command line when you invoke TrapDoor.  
  119.  
  120.        Please note that the keywords are neither case nor position
  121.      sensitive.  
  122.  
  123.  
  124.      Installation
  125.  
  126.  
  127.      Page 3              TrapDoor's Fourth Manual               Page 3
  128.  
  129.  
  130.   2.1. The Keyfile    
  131.  
  132.        TrapDoor is a Shareware program. The unregistered version will
  133.      pop up requesters at the start and end of the program, and you
  134.      will have to click some buttons with your mouse, or press some
  135.      keys. Also, a few other functions are disabled in the
  136.      unregistered version: 
  137.  
  138.        - it will exit after every call 
  139.        - it will not respond to file requests 
  140.  
  141.        Once you register, you will receive a so-called keyfile (to
  142.      "unlock" your TrapDoor), which will make these requesters go
  143.      away and enable all features of TrapDoor.  
  144.  
  145.        For more information about "Shareware", and the registration
  146.      process, please see the "Registration" chapter.  
  147.  
  148.  
  149.  
  150.  
  151.   2.2. Point Setup    
  152.  
  153.        In a typical Amiga point setup, the installation of TrapDoor
  154.      will merely consist of a few steps. If you are not familiar with
  155.      FidoNet and FidoNet Point Systems at all, please read TrapDoor's
  156.      FidoNet Manual (FidoNet.Man) first.  
  157.  
  158.        1. Copy the executable "TrapDoor" to a directory where you
  159.           store your executable files. Copy "traplist.library" to
  160.           "LIBS:".  
  161.  
  162.        2. Create a new subdirectory, and assign "MAIL:" to it, if you
  163.           not already have one. Create subdirectories "MAIL:Inbound"
  164.           and "MAIL:Outbound".  
  165.  
  166.        2a. If you have already registered TrapDoor, and you have a
  167.           keyfile called "TrapDoor.key", copy this to your "MAIL:"
  168.           directory.  
  169.  
  170.        3. Copy the default configuration file to MAIL:TrapDoor.cfg.
  171.           There is an example Point configuration file in the
  172.           Examples/ directory called Point.cfg.  
  173.  
  174.        4. Use a text editor to edit MAIL:TrapDoor.cfg to suit your
  175.           system. (You can use Ed or MicroEmacs for that purpose.)
  176.           Most important, change the NAME, NODE, BOSS, CALL and
  177.           PASSWORD parameters.  
  178.  
  179.        5. That's it, you're done. Type "TrapDoor Call Boss" to call
  180.           your boss system.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.      Installation                                       Point Setup
  187.  
  188.  
  189.      Page 4              TrapDoor's Fourth Manual               Page 4
  190.  
  191.  
  192.   2.3. Node Setup    
  193.  
  194.        A FidoNet node is more complicated to set up. First, follow
  195.      the steps in the "Point Setup" section. In addition to the
  196.      directories created there, you will also need to setup a
  197.      directory for the FidoNet nodelist. Create it on any partition
  198.      large enough for at least 2 Megabytes of additional disk space,
  199.      and assign "Nodelist:" to it. Now study the manual for TrapList
  200.      and compile the FidoNet nodelist. (If you do not have a nodelist
  201.      yet, you should use TrapDoor or a terminal program to obtain one
  202.      from another FidoNet node.) 
  203.  
  204.        Next, you need to create a scheduling script in which you tell
  205.      TrapDoor to call out on certain days or during certain hours and
  206.      what systems to call. This is usually done with a cron-like
  207.      utility. Cron is a tool which executes other programs at
  208.      regularly scheduled times.  
  209.  
  210.        There is a good cron from TelePro Technologies. It is called
  211.      TPTCron and freely available from many bulletin boards. TPTCron
  212.      has successfully been used in many installations with TrapDoor.  
  213.  
  214.        The main idea in a node setup is to run TrapDoor in answer
  215.      mode. It will accept incoming calls and wait for ARexx commands.
  216.      Then, you use cron to run "TrapPoll" every so often. TrapPoll is
  217.      a tool that will scan your outbound directory to see what mail
  218.      has to be delivered to which nodes, and send ARexx commands to
  219.      TrapDoor to cause these nodes to be called. If you have TrapPoll
  220.      executed by cron every ten minutes, TrapDoor will make outgoing
  221.      calls until all mail and files have been sent, or until an
  222.      accounting limit was reached (see the "Accounting" chapter for a
  223.      description of the accounting system).  
  224.  
  225.        By properly setting up your crontab file, you are able to
  226.      exactly specify at what times TrapDoor should place outgoing
  227.      calls, and when it should just sit around and wait for incoming
  228.      calls. Also, you can run other scripts from cron that change
  229.      TrapDoor's settings (like switching to BBSMODE ZMH during the
  230.      Zone Mail Hour).  
  231.  
  232.        Please see the Examples/ directory for many example scripts
  233.      for running a node.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.      Installation                                        Node Setup
  249.  
  250.  
  251.      Page 5              TrapDoor's Fourth Manual               Page 5
  252.  
  253.  
  254.   2.4. The Modem    
  255.  
  256.        The Modem must be Hayes compatible. Other modem command
  257.      standards are currently not supported.  
  258.  
  259.        A word about cabling: you will need a seven-wire RS232C cable,
  260.      that is one that supports at least RxD, TxD, CTS, RTS, DTR, DSR,
  261.      DCD and last but not least, Gnd. Anything less (or other
  262.      connections) may not have the desired effect, although the
  263.      strict requirements which TrapDoor poses on the DSR signal can
  264.      be bypassed by use of the NODSR keyword. Also, seven wire
  265.      handshake can be disabled with NO7WIRE.  
  266.  
  267.        Be sure to set up your modem so that dropping DTR causes a
  268.      hangup, and a return to command state -- even better a complete
  269.      reset. If you don't do this, TrapDoor will be incapable of
  270.      hanging up correctly! On almost all Hayes compatible modems this
  271.      can be achieved with AT&D3, a few may require changes to their
  272.      DIP switch settings or S-registers. Please consult the manual
  273.      that comes with your modem if you feel unsure.  
  274.  
  275.        Also, take care that your modem should respond to successful
  276.      connects with a "CONNECT XXXX" message (where XXXX is the
  277.      baudrate), not just "CONNECT" (except at 300 baud). If your
  278.      modem returns only "CONNECT", TrapDoor assumes that the
  279.      connection takes place at 300 baud. On most Hayes compatible
  280.      modems you will have to use ATX1 or higher. If your modem
  281.      returns "CONNECT FAST" (Trailblazer modems do), TrapDoor will
  282.      continue to operate at the baudrate specified in the BAUD
  283.      statement.  
  284.  
  285.        When DTR is set high, DSR should follow. In case your modem is
  286.      reacting too slow, try adjusting the SLOWMODEM parameter. If
  287.      your modem cannot properly handle DSR at all, use the NODSR
  288.      setting.  
  289.  
  290.        Some modems require a substantial delay between the "AT"
  291.      prefix and the actual command string. If this is the case with
  292.      your modem, put at least one tilde ("~") character in between
  293.      the "AT" prefix and the command. This will cause TrapDoor to
  294.      wait a short time before sending the rest of the string. Fine
  295.      tune the time with SLOWMODEM. Some modems also require a
  296.      substantial delay after a reset (caused by DTR drop or ATZ)
  297.      before they respond to commands again -- insert tilde characters
  298.      where appropriate! 
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.      Installation                                         The Modem
  311.  
  312.  
  313.      Page 6              TrapDoor's Fourth Manual               Page 6
  314.  
  315.  
  316.   2.5. Example Modem Settings   
  317.  
  318.   2.5.1. US Robotics Courier HST Modems 
  319.  
  320.        These are the settings for a Dual Standard HST modem. If you
  321.      have the HST only or V.32 only version of the Courier, just set
  322.      the parameters that apply to your modem only.  
  323.  
  324.      USRobotics Courier 14400 HST Dual Standard NRAM Settings...
  325.  
  326.         DIAL=PULSE  B1  F1  M3  X7
  327.         BAUD=19200  PARITY=N  WORDLEN=8
  328.  
  329.         &A3  &B1  &G0  &H1  &I0  &J0  &K3  &L0
  330.         &M4  &N0  &P0  &R2  &S0  &X0  &Y1
  331.  
  332.         S02=043   S03=013   S04=010   S05=008
  333.         S06=007   S07=060   S08=002   S09=006
  334.         S10=007   S11=070   S12=050   S13=001
  335.         S15=008   S19=002   S21=010   S22=017
  336.         S23=019   S24=150   S26=000   S27=000
  337.         S28=008   S38=000
  338.  
  339.         STORED PHONE #0: 
  340.                      #1: 
  341.                      #2: 
  342.                      #3: 
  343.  
  344.        To setup your modem, enter a terminal program. Select the
  345.      baudrate at which you want to "lock" your modem, usually 19200
  346.      baud. (Warning: the serial.device of the Amiga - up to AmigaOS
  347.      1.3.3 - can not keep up with 38400 baud. Unless you have a
  348.      faster processor, like a 68020 or 68030, you will get lots of
  349.      transmission errors if you choose a higher baudrate than 19200.)
  350.      Then type 
  351.  
  352.           AT&FM3X7&A3&B1&H1&K3&R2S13=1S15=8&W 
  353.  
  354.      and press return. Your modem is now set up for use with
  355.      TrapDoor.  
  356.  
  357.        In your TrapDoor.cfg file, use the lines 
  358.  
  359.           BAUD 19200 LOCK
  360.           7WIRE
  361.           SLOWMODEM 10
  362.           MODEMINIT "~~ATZ|"
  363.           MODEMHANGUP "|^"
  364.           MODEMDIALPRE "~~ATB1DP"
  365.           MODEMDIALPOST "|"
  366.           MODEMANSWER "~~ATB0S7=30A|"
  367.           ARQSTRING "ARQ" SNIFFARQ
  368.  
  369.  
  370.  
  371.  
  372.      Installation                             Example Modem Settings
  373.  
  374.  
  375.      Page 7              TrapDoor's Fourth Manual               Page 7
  376.  
  377.  
  378.   2.5.2. Ordinary 2400 Baud Modems  
  379.  
  380.        Set your modem to: 
  381.  
  382.           E1  echo modem commands
  383.           Q0  display result codes
  384.           V1  verbose results
  385.           X1  or higher
  386.           &C1 DCD follows carrier detect
  387.           &D3 reset on dtr drop
  388.           &S0 DSR always on
  389.  
  390.        To setup your modem, enter a terminal program and set the
  391.      baudrate to 2400 baud. Then type 
  392.  
  393.           AT&FE1Q0V1X4&C1&D3&S0&W 
  394.  
  395.      and press return. You modem is now set up for use with
  396.      TrapDoor.  
  397.  
  398.        In your TrapDoor.cfg file, use the lines 
  399.  
  400.           BAUD 2400
  401.           SLOWMODEM 10
  402.           MODEMINIT "~~AT~Z|~"
  403.           MODEMHANGUP "|^"
  404.           MODEMDIALPRE "~~AT~DP"
  405.           MODEMDIALPOST "|~"
  406.           MODEMANSWER "~~AT~A|~"
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.      Installation                             Example Modem Settings
  435.  
  436.  
  437.      Page 8              TrapDoor's Fourth Manual               Page 8
  438.  
  439.  
  440.   2.5.3. Internal Supra 2400zi Modems  
  441.  
  442.        Set your modem to: 
  443.  
  444.             E1 L2 M1 Q0 V1 X4 B0 Y0
  445.             &C1 &D3 &G0 &J0 &L0 &M0 &P0 &S0
  446.  
  447.             S0=0 S2=43 S3=13 S4=10 S5=8 S6=2 S7=20 S8=2 S9=6
  448.             S10=14 S12=50 S25=5 S26=1
  449.  
  450.        To setup your modem, enter a terminal program that can talk to
  451.      "modem0.device" and set the baudrate to 2400 baud. Then type 
  452.  
  453.           AT&FE1Q0V1X4&C1&D3&S0&W 
  454.  
  455.      and press return. You modem is now set up for use with
  456.      TrapDoor.  
  457.  
  458.        In your TrapDoor.cfg file, use the lines 
  459.  
  460.           SERIALNAME "modem0.device"
  461.           BAUD 2400
  462.           SLOWMODEM 10
  463.           MODEMINIT "~~AT~Z|~"
  464.           MODEMHANGUP "|^"
  465.           MODEMDIALPRE "~~AT~DP"
  466.           MODEMDIALPOST "|~"
  467.           MODEMANSWER "~~AT~A|~"
  468.  
  469.  
  470.  
  471.  
  472.  
  473.   2.5.4. Supra V.32bis    
  474.  
  475.        Users of this modem recommend to set ATS95=2W2. We have not
  476.      tested this modem.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.      Installation                             Example Modem Settings
  497.  
  498.  
  499.      Page 9              TrapDoor's Fourth Manual               Page 9
  500.  
  501.  
  502.   2.5.5. ZyXEL Modems    
  503.  
  504.        These are the settings for a ZyXEL 1496 E modem, ROMs 5.00a.
  505.      If you have one of the other models, the parameters are the
  506.      same.  
  507.  
  508.      Current   Setting.............
  509.  
  510.       B0   E1   L1   M1   N1   Q0   V1   X7  
  511.      &B1  &C1  &D3  &G0  &H3  &J0  &K4  &L0  &M0  &N0  &P0  &R1
  512.                                                   &S0  &X0  &Y1
  513.      *B0  *C0  *D0  *E0  *F0  *G0  *I0  *L0  *M0  *P9  *Q2  *S0  
  514.  
  515.      S00=000   S01=000   S02=043   S03=013   S04=010   
  516.      S05=008   S06=003   S07=060   S08=002   S09=006   
  517.      S10=015   S11=050   S12=000   S13=000   S14=002   
  518.      S15=002   S16=000   S17=018   S18=002   S19=000   
  519.      S20=001   S21=242   S22=000   S23=121   S24=034   
  520.      S25=000   S26=000   S27=156   S28=068   S29=000   
  521.      S30=000   S31=017   S32=019   S33=000   S34=030   
  522.      S35=000   S36=000   S37=000   S38=008   S39=000   
  523.      S40=000   S41=000   S42=000   S43=000   S44=000   
  524.      S45=000   S46=000   S47=000   S48=000   S49=000   
  525.  
  526.        To setup your modem, enter a terminal program. Select the
  527.      baudrate at which you want to "lock" your modem, usually 19200
  528.      baud. (Warning: the serial.device of the Amiga - up to AmigaOS
  529.      1.3.3 - can not keep up with 38400 baud. Unless you have a
  530.      faster processor, like a 68020 or 68030, you will get lots of
  531.      transmission errors if you choose a higher baudrate than 19200.)
  532.      Then type 
  533.  
  534.           AT&FX7&D3&W 
  535.  
  536.      and press return. Your modem is now set up for use with
  537.      TrapDoor.  
  538.  
  539.        In your TrapDoor.cfg file, use the lines 
  540.  
  541.           BAUD 19200 LOCK
  542.           7WIRE
  543.           SLOWMODEM 10
  544.           MODEMINIT "~~ATZ|"
  545.           MODEMHANGUP "|^"
  546.           MODEMDIALPRE "~~ATDP"
  547.           MODEMDIALPOST "|"
  548.           MODEMANSWER "~~ATA|"
  549.           ARQSTRING "ARQ" SNIFFARQ
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.      Installation                             Example Modem Settings
  559.  
  560.  
  561.      Page 10             TrapDoor's Fourth Manual              Page 10
  562.  
  563.  
  564.   3. Basics     
  565.  
  566.        This chapter is intended to give you a quick overview about
  567.      the operation of TrapDoor and certain selected topics. If you
  568.      wish to look up a specific command keyword, please see the
  569.      reference section "Configuration Commands".  
  570.  
  571.   3.1. FidoNet     
  572.  
  573.        FidoNet is a world-wide network of many "FidoNet-compatible"
  574.      bulletin boards, which communicate with each other using
  575.      "mailers". TrapDoor is one of these mailers, it allows you to
  576.      send and receive FidoNet mail and files.  
  577.  
  578.        If you are not familiar with FidoNet, or certain terms used in
  579.      this manual, please see "TrapDoor's FidoNet Manual"
  580.      (FidoNet.Man) and the glossary there.  
  581.  
  582.   3.2. Mailer Operation    
  583.  
  584.        A mailer transfers mail bundles and/or files to/from another
  585.      FidoNet system. You (or other mail packing software) prepare the
  586.      outgoing mail and files in a so-called "outbound directory". You
  587.      then tell TrapDoor to call another FidoNet system. TrapDoor will
  588.      use the modem to place a telephone call there, then proceed to
  589.      transfer mail/files with built-in protocols.  Also, TrapDoor
  590.      will receive mail and files that are waiting at the other system
  591.      for you. These incoming data will be stored in the "inbound
  592.      directory", from where you (or the mail tossing software) can
  593.      further process the mail and files.  
  594.  
  595.        A more detailed description of this process and the
  596.      interaction between TrapDoor and mail processing software is
  597.      given in TrapDoor's FidoNet Manual.  
  598.  
  599.   3.3. Nodelist     
  600.  
  601.        A "nodelist" is a directory listing all (or parts of) the
  602.      nodes in FidoNet. It stores the names of systems and sysops, the
  603.      node numbers, and the telephone number for each node. TrapDoor
  604.      can use the nodelist to look-up telephone numbers before placing
  605.      an outgoing call.  
  606.  
  607.        A separate program called "TrapList" is used to process the
  608.      nodelist before TrapDoor can reference it. TrapList builds index
  609.      files for the nodelist, which TrapDoor later uses. For more
  610.      information on TrapList and how to compile/index nodelists,
  611.      please see "TrapList's Faaaast Manual" (TrapList.Man).  
  612.  
  613.        Point systems do not necessarily need a nodelist, as they only
  614.      call one single "boss" system, the telephone number of which can
  615.      be stored in TrapDoor's configuration file.  
  616.  
  617.  
  618.  
  619.  
  620.      Basics                                               Nodelist
  621.  
  622.  
  623.      Page 11             TrapDoor's Fourth Manual              Page 11
  624.  
  625.  
  626.   3.4. Compatibility     
  627.  
  628.        A sensitive point in every FidoNet mailer is "compatibility".
  629.      FidoNet uses at least three different handshake methods and more
  630.      than three different transfer protocols. Not every mailer
  631.      implements all of them, and so it is very important that mailers
  632.      automatically detect the capabilities of the other system and
  633.      switch to the correct handshake and protocol. This detection
  634.      phase is also one of the sources of most errors and failures to
  635.      establish a proper connection between two FidoNet systems.  
  636.  
  637.        TrapDoor has been extensively tested with other mailers,
  638.      including various versions of BinkleyTerm, D'Bridge, FrontDoor,
  639.      Paragon and TrapDoor itself. It should work fine with most
  640.      systems.  
  641.  
  642.        There are two additional notes about compatibility, however.
  643.      The EMSI handshake method sometimes causes problems with some
  644.      BBSs with an integrated mailer, such as some older versions of
  645.      Opus or Paragon. Should you repeatedly experience strange
  646.      hangups with such a system, you should disable EMSI using the
  647.      NOEMSI keyword and try again. Especially older version of
  648.      Paragon are known to not work correctly with EMSI. If you
  649.      regularly call such a system, you might want to set up a "custom
  650.      configuration" for that system (see the next chapter).  
  651.  
  652.        Second, the FTS-1 "Lotek" protocol is very often poorly
  653.      implemented in other mailers. TrapDoor uses a very strict
  654.      version of this protocol, and behaves exactly according to the
  655.      specifications. Other mailers with errors in their FTS-1
  656.      protocol code fail with TrapDoor. Two known cases are Tabby, a
  657.      Macintosh mailer, which fails completely, and TIMS, an MS-DOS
  658.      mailer, which sometimes fails to transfer the names of inbound
  659.      files. TrapDoor will name the files "Unnamed.File",
  660.      "Unnamed.File,1", "Unnamed.File,2" etc. Also, in the case of
  661.      unnamed files, the files themselves may have some Ctrl-Z (hex
  662.      1A) characters at the very end, padding their size to an even
  663.      multiple of 128 bytes.  
  664.  
  665.   3.5. Custom Configuration Entries   
  666.  
  667.        Sometimes it is desirable to use a special custom
  668.      configuration when calling a certain node. For example, if you
  669.      regularly connect to a Paragon system which cannot handle EMSI,
  670.      you will want to disable EMSI when calling that node.  
  671.  
  672.        TrapDoor allows you to set up such custom configuration
  673.      entries.  There is a utility called "setconfig" to store a
  674.      configuration string for a certain node number. For example, to
  675.      disable EMSI for 2:314/471, enter 
  676.  
  677.           setconfig 2:314/471 "NOEMSI" 
  678.  
  679.  
  680.  
  681.  
  682.      Basics                             Custom Configuration Entries
  683.  
  684.  
  685.      Page 12             TrapDoor's Fourth Manual              Page 12
  686.  
  687.  
  688.        Custom configurations are very flexible. For example, you
  689.      might have to use special modem settings to call some node.
  690.      Using the setconfig utility, you enter 
  691.  
  692.           setconfig 3:504/132 "BAUD 7200 MODEMDIALPRE  \ on one 
  693.                                 ATS42.3=1X29S133=45DT" / line 
  694.  
  695.        Or, to override a telephone number from the nodelist: 
  696.  
  697.           setconfig 2:253/500 "CALL 0044-44-123-1234" 
  698.  
  699.        Here is another trick: if a node has been marked as
  700.      -Undialable- in the nodelist, TrapDoor will refuse to call it.
  701.      It will instead display something like "The Mad House (2:310/6)
  702.      is undialable". If you know the telephone number of that system,
  703.      you can enter 
  704.  
  705.           setconfig 2:310/6 "CALL 0043-1-556-7863 COST 833" 
  706.  
  707.        It is important that you specify the COST parameter here. Give
  708.      it the cost per minute for that call.  
  709.  
  710.        If you lose track of your custom configuration entries, the
  711.      listconfig utility will list them all: 
  712.  
  713.          Node           : Config
  714.         ------------------------
  715.         2:310/6.0       : call 12341234 cost 6700
  716.         2:512/17.0      : MODEMDIALPRE ATS7=60B0X7DP NOEMSI
  717.         1:125/111.0     : NOEMSI
  718.  
  719.         Total 3 nodes in database
  720.  
  721.   3.6. Accounting     
  722.  
  723.        TrapDoor can keep a count of all outgoing calls and incoming
  724.      calls, on a per node basis, and the cost for those calls. When
  725.      you have enabled accounting (see the (NO)ACCOUNTING keyword),
  726.      TrapDoor will maintain a database of 
  727.  
  728.        - the number of outgoing calls to a node
  729.        - the number of incoming calls from a node
  730.        - the number of successful sessions with a node
  731.        - the number of failed sessions with a node
  732.        - the number of BUSY signals when calling a node
  733.        - the number of NO CARRIER signals when calling a node
  734.        - the number of VOICE signals when calling a node
  735.        - the total cost of all outgoing calls to a node
  736.        - the TrxID (a timestamp) of the last successful connection
  737.          with that node 
  738.  
  739.        The "listacct" tool will display all the accounting
  740.      information, and "clearacct" will reset it, either on an
  741.      individual basis or for all nodes.  
  742.  
  743.  
  744.      Basics                                             Accounting
  745.  
  746.  
  747.      Page 13             TrapDoor's Fourth Manual              Page 13
  748.  
  749.  
  750.        By using the ACCTMAX keyword, you can specify maxima for all
  751.      of the above accounting items. You can set limits, and TrapDoor
  752.      will refuse to call a node when at least one of the limits is
  753.      exceeded. For example, you could set the maximum for the number
  754.      of failed sessions to 2, and TrapDoor will refuse to call a node
  755.      again after two failed connects (where a connection was made,
  756.      but the carrier was lost before the successful end of the
  757.      session).  
  758.  
  759.   3.7. Security     
  760.  
  761.        It is often important to make sure that a particular system is
  762.      really who it claims to be. For that reason, TrapDoor can use
  763.      passwords to protect mail sessions. You can set up a password
  764.      for each node you regularly exchange mail with, and TrapDoor
  765.      will check the password every time this node calls you. If the
  766.      password which the other end sends and the password that is
  767.      stored in the local database do not match, TrapDoor will hang
  768.      up, or, if the password for an AKA address is wrong, it will
  769.      simply "forget" that AKA and will continue the session without
  770.      sending mail or files for the AKA address.  
  771.  
  772.        The "setpasswd" tool allows you to set up or remove passwords.
  773.      For example, to setup a password of "vienna" for 2:313/28, enter 
  774.  
  775.           setpasswd 2:313/28 "vienna" 
  776.  
  777.        TrapDoor will always compare passwords using a
  778.      case-insignificant match. It will, however, send out passwords
  779.      exactly as you typed them, in case the other end does not use a
  780.      case-insensitive compare.  
  781.  
  782.        To protect you from losing your password database in case of a
  783.      system crash, you can also enter "Password" statements in your
  784.      TrapList configuration file and have TrapList set up all your
  785.      passwords. This is described in more detail in the manual for
  786.      TrapList.  
  787.  
  788.        If you are running a private system, and you do not want to
  789.      receive calls from any other nodes except the ones with which
  790.      you have established passwords, you can set up a secret password
  791.      using the PASSWORD keyword. Other mailers will only be able to
  792.      connect to your system if either (a) they know the secret
  793.      password or (b) you have set up another password for them (using
  794.      setpasswd) and they send the latter one.  
  795.  
  796.        If you are running a public FidoNet node, do not use the
  797.      PASSWORD configuration keyword.  
  798.  
  799.   3.8. File Tagging    
  800.  
  801.        Another security feature of TrapDoor is "file tagging". Each
  802.      received file will be tagged with a "Secure" field in the
  803.      filenote, if it was received either from a node listed in the
  804.  
  805.  
  806.      Basics                                            File Tagging
  807.  
  808.  
  809.      Page 14             TrapDoor's Fourth Manual              Page 14
  810.  
  811.  
  812.      nodelist or from a node with which a password was set up. The
  813.      "Secure"-Tag will contain either "NL" or "PW" or both "NL,PW"
  814.      depending on the particular security measures under which the
  815.      file was received. This can be used by a mail tosser to toss
  816.      only mail from password-protected sessions automatically, for
  817.      example.  
  818.  
  819.        Also, every file received will be tagged with the node number
  820.      of the system from which it was received, in a "From" field.  
  821.  
  822.        Every FidoNet session will be assigned a unique number. This
  823.      number will be recorded in the log file, and all files received
  824.      in this session will be tagged with a "Trx" field listing this
  825.      unique "transaction id".  
  826.  
  827.        If files were renamed during the receive operation (for
  828.      example, because the file already existed), the original
  829.      filename will be stored in another field in the filenote, tagged
  830.      as "FileName".  
  831.  
  832.   3.9. Refusing and Pickup Preferences  
  833.  
  834.        The Emsi handshake allows for "Refusing" and "Pickup
  835.      Preferences". These features work only when an Emsi handshake
  836.      was chosen at the beginning of the session.  
  837.  
  838.        Refusing means that a system may refuse to receive certain
  839.      files or certain mail packets at specific times. A system may
  840.      refuse 
  841.  
  842.        - file requests
  843.        - compressed mail
  844.        - file attaches
  845.        - all of the above
  846.  
  847.        TrapDoor will respect these wishes and not send the
  848.      appropriate items, unless NOALLOWREFUSING is in effect.  
  849.  
  850.        Pickup Preferences means that another system may choose what
  851.      mail or files to pick up from TrapDoor. A system may want to
  852.      pick up mail and files 
  853.  
  854.        - for all presented addresses
  855.        - for the primary address only (no AKAs)
  856.        - no pickup at all
  857.  
  858.        TrapDoor will respect these preferences and only send the
  859.      requested items. (NO)ALLOWREFUSING does not affect this
  860.      behaviour.  
  861.  
  862.        To set up your own Refusing or Pickup Preferences, use the
  863.      FORBID and PICKUP keywords. The default is to pick up mail for
  864.      all presented addresses, and to not refuse to receive anything.  
  865.  
  866.  
  867.  
  868.      Basics                           Refusing and Pickup Preferences
  869.  
  870.  
  871.      Page 15             TrapDoor's Fourth Manual              Page 15
  872.  
  873.  
  874.   3.10. The Keyboard    
  875.  
  876.        TrapDoor now features sophisticated keyboard handling,
  877.      including the ability to assign arbitrary configuration commands
  878.      to function keys.  
  879.  
  880.        One of the most important keys is probably the ESC (Escape)
  881.      key. Pressing this key during a session will abort it. TrapDoor
  882.      will hangup as soon as possible and either return to answer
  883.      mode, or, if the call was not initiated from answer mode, exit.
  884.      When TrapDoor is idle and you press the ESC key, it will reset
  885.      the modem.  
  886.  
  887.        Next, TrapDoor makes use of the Alt (Alternate) key for system
  888.      functions.  When TrapDoor is idle and waiting in answer mode,
  889.      you can activate a number of things via Alt-key sequences. The
  890.      Alt key works like a shift key, you have to hold it down while
  891.      pressing another key. These are the Alt key sequences that
  892.      TrapDoor understands: 
  893.  
  894.          Alt-A ... immediately Answer the phone.  
  895.          Alt-C ... reread the Config file "MAIL:TrapDoor.cfg".  
  896.                    This is useful if you have changed the config file
  897.                    and want to reset TrapDoor to the new settings.  
  898.          Alt-Q ... Quit, same as Alt-X.  
  899.          Alt-R ... Reset modem.  
  900.          Alt-S ... toggle Showrexx mode (see SHOWREXX keyword).  
  901.          Alt-X ... eXit, same as Alt-Q.  
  902.  
  903.        If you get stuck and cannot remember a certain key, just press 
  904.  
  905.          HELP .... pop up the Help display.  
  906.                    Please note that TrapDoor will wait for the Help
  907.                    window to close before it exits.  
  908.  
  909.        From the main help window, you can select "Settings" or
  910.      "Keys". "Settings" will give you a short summary of all the
  911.      current settings of your TrapDoor, "Keys" will show you a
  912.      summary of all standard key assignments of TrapDoor. Select
  913.      "Done" when finished reading. From the "Keys" display, you can
  914.      also choose "F-Keys" which will show you a summary of the
  915.      current function key assignments.  
  916.  
  917.        Function key assignments can be put on any of the function
  918.      keys (reasonable, eh?). These are the keys in the topmost row of
  919.      your Amiga keyboard, beside the ESC key. The FKEY keyword is
  920.      used to assign function keys. When you press a function key, and
  921.      there is an assignment for it, TrapDoor will send the string
  922.      assigned to that key to its own ARexx port. From there, the
  923.      assignment will be processed. That way, you can put things like
  924.      "Call 2:310/6" or "NOEMSI" on your function keys, or you can
  925.      start external programs with the "Run" and "Spawn" keywords.  
  926.  
  927.  
  928.  
  929.  
  930.      Basics                                            The Keyboard
  931.  
  932.  
  933.      Page 16             TrapDoor's Fourth Manual              Page 16
  934.  
  935.  
  936.        Always remember that hitting a function key will cause
  937.      TrapDoor to send an ARexx-message to itself. Thus, it will only
  938.      process that keystroke when it is idle in answer mode. (It will
  939.      actually process the keypress immediately, but the ARexx-message
  940.      will be waiting at the ARexx-port until TrapDoor reads it when
  941.      it comes back to the "Waiting for call" state.) 
  942.  
  943.  
  944.  
  945.  
  946.   3.11. Return Values    
  947.  
  948.        When TrapDoor returns to the calling program, the following
  949.      returncodes indicate its success or failure: 
  950.  
  951.           0 ... everything successfully completed.  
  952.           5 ... some minor problem occurred 
  953.                 Either no session could be established (BUSY, NO
  954.                 CARRIER, VOICE etc.) or something went wrong during a
  955.                 session (timeouts, too many retries, carrier lost
  956.                 etc.). This can only occur if you do not start
  957.                 TrapDoor in answer mode, but immediately tell it to
  958.                 make a call, i.e. TrapDoor Call 2:310/6.  
  959.          20 ... some fatal error prohibited any further action.  
  960.                 TrapDoor could not open its window, screen, serial
  961.                 device or timer device, allocate memory or other
  962.                 necessary items.  
  963.  
  964.        More detailed result codes are available through the ARexx
  965.      interface. See the STATUS command.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.      Basics                                           Return Values
  993.  
  994.  
  995.      Page 17             TrapDoor's Fourth Manual              Page 17
  996.  
  997.  
  998.   3.12. ARexx     
  999.  
  1000.        TrapDoor includes an ARexx port -- while in answer mode
  1001.      waiting for incoming calls, TrapDoor also accepts ARexx
  1002.      messages. The port name, which is also called the "host name" in
  1003.      ARexx symbolics, is usually "TrapDoor", unless you change it
  1004.      with the REXXNAME keyword. Use this name in Rexx "Address ..."
  1005.      statements to select TrapDoor.  
  1006.  
  1007.        All commands and keywords listed in the "Configuration
  1008.      Keywords" section can be sent to the ARexx port and will be
  1009.      understood, although some might not behave as expected. (For
  1010.      example, if you change SERIALNAME while in answer mode, TrapDoor
  1011.      will not switch to the new device. Instead, you should terminate
  1012.      TrapDoor and run it again with a different setup.) 
  1013.  
  1014.        Apart from that, almost everything that can be set up from the
  1015.      command line (or a config file) can also be done via the ARexx
  1016.      port.  
  1017.  
  1018.        Some commands can only be used from ARexx (or TrapTell). Those
  1019.      keywords are marked with 
  1020.  
  1021.        (+) ARexx only command 
  1022.  
  1023.        Attempts to use them from CLI will cause nothing but an error
  1024.      message.  
  1025.  
  1026.        Usually, ARexx commands will be executed whenever TrapDoor is
  1027.      idle and waiting for a call. Some ARexx commands can also be
  1028.      sent for immediate execution. In that case, the command will be
  1029.      executed immediately, no matter whether or not TrapDoor is just
  1030.      connected to another system and a mail session takes place. For
  1031.      immediate execution, the command must be prepended with an "at"
  1032.      character ("@"). Such keywords are marked with 
  1033.  
  1034.        (@) asynchronous execution possible 
  1035.  
  1036.        Here are a few examples: 
  1037.  
  1038.           /* This is a Rexx script to call my boss. TrapDoor must
  1039.              already be running in Answer mode. */
  1040.  
  1041.           options results
  1042.           address "TrapDoor"
  1043.  
  1044.           "Call Boss"
  1045.           "Status D"
  1046.           say "Modem returned" RESULT "from the last call."
  1047.           "Status X"
  1048.           say "The last call terminated with error" RESULT"."
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.      Basics                                                  ARexx
  1055.  
  1056.  
  1057.      Page 18             TrapDoor's Fourth Manual              Page 18
  1058.  
  1059.  
  1060.        Should you happen not to have a copy of ARexx handy, no
  1061.      problem -- the tool TrapTell simulates an ARexx server, sending
  1062.      a message to TrapDoor and waiting for the results.  
  1063.  
  1064.        Here is an example. It stops a running TrapDoor by sending it
  1065.      a "Quit" command.  
  1066.  
  1067.           TrapTell "Quit" 
  1068.  
  1069.        Here's another example. First, we start up TrapDoor in answer
  1070.      mode, but we do not want it to react to incoming calls, so we
  1071.      set the RINGS limit very high. Immediately after launching
  1072.      TrapDoor, we wait a few seconds so TrapDoor has time to
  1073.      initialize everything and open its ARexx port.  
  1074.  
  1075.           run TrapDoor answer rings 50000 
  1076.           wait 5 secs 
  1077.  
  1078.        Then, I'd like to call node 1:200/300 and get the connect
  1079.      result string: 
  1080.  
  1081.           TrapTell "call 1:200/300" 
  1082.           TrapTell "status d" 
  1083.  
  1084.        Try it, you should soon become familiar with that method of
  1085.      controlling programs. There are some example AmigaDOS scripts
  1086.      that use the TrapTell command in the Scripts/ subdirectory on
  1087.      the distribution disk (or in the distribution archive) and there
  1088.      are some more ARexx programs that make use of TrapDoor's ARexx
  1089.      port in the rexx/ subdirectory.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.   3.13. Dial Scripts    
  1097.  
  1098.        Sometimes, the built-in modem dialer in TrapDoor is not
  1099.      sophisticated enough. It will do fine for a normal telephone
  1100.      link between two nodes, but in some cases, two nodes might be
  1101.      linked via a packet switched network, a private network
  1102.      exchange, PCP, Telnet, Datex-P or whatever else there is.  
  1103.  
  1104.        In these networks, it is usually necessary to log onto the
  1105.      network, identify yourself, and then select the network address
  1106.      or data telephone number with which you'd like to connect. Then,
  1107.      the network system will connect you, and only after that you
  1108.      will be able to establish your normal FidoNet session.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.      Basics                                            Dial Scripts
  1117.  
  1118.  
  1119.      Page 19             TrapDoor's Fourth Manual              Page 19
  1120.  
  1121.  
  1122.        TrapDoor features a tiny script language to accommodate this
  1123.      method of communication. You will have to write ARexx-scripts
  1124.      for your specific data network using the STIMEOUT, SWRITE,
  1125.      SMODEM, SLINE, SCLEAR and SWAIT commands. As soon as you have
  1126.      connected to the other FidoNet system, you issue the
  1127.      STARTSESSION command. Then, TrapDoor will take over again and
  1128.      proceed with a normal FidoNet session.  
  1129.  
  1130.        Here is a short example: 
  1131.  
  1132.           /* This is a Rexx script to connect to some other system
  1133.              via a custom data network. TrapDoor should already be
  1134.              running in Answer mode. */
  1135.  
  1136.           address "TrapDoor"
  1137.  
  1138.           STIMEOUT 10
  1139.           SMODEM "~~ATZ|"      /* initialize the modem */
  1140.           SWAIT OK
  1141.           STIMEOUT 60
  1142.           SMODEM "ATDP1234"    /* call the data network */
  1143.           SWAIT CONNECT
  1144.           SWAIT "login:"       /* wait for login prompt */
  1145.           SWRITE "mad max"||d2c(13)    /* send username */
  1146.           SWAIT "password:"
  1147.           SWRITE "secret"||d2c(13)
  1148.           SWAIT "*"                  /* wait for prompt */
  1149.           SWRITE "c 345-17635132#"||d2c(13)
  1150.           SWAIT "connection ok"
  1151.           STARTSESSION             /* begin the session */
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.   3.14. Multiple Lines    
  1158.  
  1159.        TrapDoor can be run on multiple telephone lines. In order to
  1160.      reduce memory usage, we recommend making TrapDoor resident. This
  1161.      is achieved with the AmigaDOS Resident command as in 
  1162.  
  1163.           Resident Mail:bin/TrapDoor       ; or wherever TrapDoor
  1164.                                            ; resides on your system
  1165.  
  1166.        Next, you have to start each invocation of TrapDoor with
  1167.      different parameters for SERIALNAME or at least SERIALUNIT, and
  1168.      REXXNAME. TrapDoor will refuse to open if the serial device or
  1169.      the ARexx portname is already in use.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.      Basics                                          Multiple Lines
  1179.  
  1180.  
  1181.      Page 20             TrapDoor's Fourth Manual              Page 20
  1182.  
  1183.  
  1184.        Let us assume your configuration file contains, among other
  1185.      things, the statements 
  1186.  
  1187.           SerialName "serial.device"
  1188.           SerialUnit 0
  1189.  
  1190.      Now, the commands 
  1191.  
  1192.           Run TrapDoor SerialUnit 1 RexxName "TrapDoor-1"
  1193.           Run TrapDoor SerialUnit 2 RexxName "TrapDoor-2"
  1194.           Run TrapDoor SerialName other.device RexxName "TrapDoor-3"
  1195.  
  1196.      will start three copies of TrapDoor. The first one will use
  1197.      serial.device, unit 1, and its ARexx-port will be named
  1198.      "TrapDoor-1"; the second will use serial.device, unit 2,
  1199.      "TrapDoor-2"; and the third one will use a special serial device
  1200.      named other.device, unit 0, and an ARexx-port of "TrapDoor-3".  
  1201.  
  1202.        It is often useful to have separate configuration files for
  1203.      multiple lines, and change not only the above parameters, but
  1204.      also things like the window positions and sizes (LOGWINDOW,
  1205.      STATWINDOW) etc. Also note that there is a special SCREENMODE
  1206.      TRAPDOOR, which is very much like SCREENMODE CUSTOM, the
  1207.      difference being only that all invocations of TrapDoor will open
  1208.      their windows on the same shared TrapDoor-screen. (The first
  1209.      invocation of TrapDoor will open the screen, and the screen will
  1210.      close only after the last copy of TrapDoor has been shut down.).
  1211.      If you are using Kickstart 2.04 or higher, you can also use the
  1212.      new SCREENMODE PUBLIC, which works identically to SCREENMODE
  1213.      TRAPDOOR, but takes advantage of the KS 2.04 "Public Screens".
  1214.      That means that other programs can also share the TrapDoor
  1215.      screen, or TrapDoor can be made to run on other public screens.  
  1216.  
  1217.        To send ARexx-commands to a specific copy of TrapDoor, use the
  1218.      ARexx ADDRESS command to select the port name. Here is an
  1219.      example: 
  1220.  
  1221.           /* This ARexx-script closes down TrapDoor on line 3 */
  1222.  
  1223.           address "TrapDoor-3"
  1224.           "quit"
  1225.  
  1226.        If you use TrapTell or TrapPoll, use the -p switch to select
  1227.      the portname, for example: 
  1228.  
  1229.           TrapTell -pTrapDoor-3 "quit" 
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.      Basics                                          Multiple Lines
  1241.  
  1242.  
  1243.      Page 21             TrapDoor's Fourth Manual              Page 21
  1244.  
  1245.  
  1246.   3.15. Logfile Buffering    
  1247.  
  1248.        Older versions of TrapDoor (up to 1.80) would flush the
  1249.      logfile after every single line of log. This would slow down the
  1250.      program, especially when the logfile grew large. Thus, TrapDoor
  1251.      now allows you to configure a maximum number of lines and a
  1252.      maximum number of seconds, during which the logfile will not be
  1253.      flushed. If any of the two values has been exceeded, and a new
  1254.      line is written to the logfile, the file will be closed and
  1255.      reopened, thus forcing all data to be written to the disk.  
  1256.  
  1257.        This is a two-edged sword: on the one hand, your system will
  1258.      become speedier if you don't let your logfile be flushed so
  1259.      often; on the other hand, if your system crashes for any reason,
  1260.      part of the logfile might not have been updated on the disk and
  1261.      you might just miss the important information that lead to the
  1262.      crash. So, you should flush the logfile at least after 10
  1263.      seconds or so or after 10 lines of information.  
  1264.  
  1265.        The logfile will always be flushed before an external program
  1266.      is run, so that the external software can add data to the
  1267.      TrapDoor logfile. Also, the logfile will be kept flushed when
  1268.      TrapDoor is idle waiting in answer mode.  
  1269.  
  1270.  
  1271.  
  1272.   3.16. Automatic Buffer Sizing   
  1273.  
  1274.        Some people have been complaining about the CPU usage of
  1275.      TrapDoor. The new feature of Automatic Buffer Sizing (ABS for
  1276.      short), if enabled, will try to reduce the CPU load of TrapDoor
  1277.      during Zmodem receiving.  
  1278.  
  1279.  
  1280.  
  1281.   3.17. Fax Support    
  1282.  
  1283.        TrapDoor can detect special "fax connect" messages from the
  1284.      modem and run some external software to receive an incoming fax.
  1285.      See the description of the FAXSTRING and FAXCOMMAND keywords.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.      Basics                                             Fax Support
  1303.  
  1304.  
  1305.      Page 22             TrapDoor's Fourth Manual              Page 22
  1306.  
  1307.  
  1308.   4. Configuration Commands    
  1309.  
  1310.        All configuration keywords are listed in the section
  1311.      "Keywords". They can be used either in the configuration file or
  1312.      on the command line. The keywords are neither case nor position
  1313.      sensitive.  
  1314.  
  1315.        The meanings of the special notes 
  1316.  
  1317.        (+) ARexx only command 
  1318.        (@) asynchronous execution possible 
  1319.  
  1320.      are explained in the "ARexx" chapter.  
  1321.  
  1322.        If you wish to include space characters (blanks) in a string
  1323.      parameter, you must surround the string with double-quote
  1324.      characters, as in 
  1325.  
  1326.           SYSOP "Maximilian Hantsch" 
  1327.  
  1328.        The backslash ('\') is used as an escape-character. For
  1329.      example, if you want to include a double-quote within a string,
  1330.      you need to use 
  1331.  
  1332.           NAME "The \"quoted\" node" 
  1333.  
  1334.        Of course, if you need a single backslash in a string, you
  1335.      need to escape it too, so you have to double each occurrance: 
  1336.  
  1337.           BANNER "A Slash / and a Backslash \\ ..." 
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.      Configuration Commands
  1365.  
  1366.  
  1367.      Page 23             TrapDoor's Fourth Manual              Page 23
  1368.  
  1369.  
  1370.   4.1. Embedded Percent-Commands    
  1371.  
  1372.        The AFTERSESSION, BBSCOMMAND, DIALER, FAXCOMMAND, FREQUEST and
  1373.      RINGCOMMAND keywords allow you to specify a commmand-string that
  1374.      will be executed. In these command-strings, the following
  1375.      embedded %-commands are permitted. All of them are
  1376.      case-sensitive.  
  1377.  
  1378.           %b ... baudrate (between computer and modem)
  1379.           %B ... baudrate (of the actual connection)
  1380.           %s ... serial device name
  1381.           %u ... serial device unit number
  1382.           %f ... serial device flags
  1383.           %r ... unique random number (timestamp)
  1384.           %l ... name of logfile
  1385.           %Z ... zone number of the other system
  1386.           %N ... net number of the other system
  1387.           %F ... fido node number of the other system
  1388.           %P ... point number of the other system
  1389.           %n ... complete FidoNet address of the other system
  1390.           %R ... name of the ARexx port of this TrapDoor
  1391.           %p ... name of the public screen
  1392.           %I ... name of inbound directory
  1393.           %O ... name of outbound directory
  1394.           %d ... direction: 1 if inbound call, -1 if outbound call
  1395.           %% ... %
  1396.  
  1397.        For the FREQUEST keyword, the following sequences are allowed
  1398.      in addition to the above: 
  1399.  
  1400.           %i ... name of the .REQ file (input file)
  1401.           %o ... name of the .RLO file (output file)
  1402.           %S ... name of Sysop of other system
  1403.  
  1404.        Please note that %b and %B are equivalent unless you use LOCK.
  1405.      In that case, %b will reflect the LOCKed baudrate, whereas %B
  1406.      will give you the baudrate of the actual connection (that was
  1407.      returned by the modem in a "CONNECT XXXX" message).  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.      Configuration Commands               Embedded Percent-Commands
  1427.  
  1428.  
  1429.      Page 24             TrapDoor's Fourth Manual              Page 24
  1430.  
  1431.  
  1432.   4.2. Modem Commands    
  1433.  
  1434.        All the modem commands (MODEMINIT, MODEMDIALPRE,
  1435.      MODEMDIALPOST, MODEMANSWER and MODEMHANGUP -- all explained
  1436.      later on) accept a few special characters in the configuration
  1437.      string. These are: 
  1438.  
  1439.           ~ ... short delay
  1440.           ^ ... drop DTR, wait a while, raise DTR again
  1441.           | ... send a carriage return character
  1442.           \ ... escape character, send next character as is
  1443.  
  1444.        All other characters will be sent to the modem unchanged and
  1445.      without any further action.  
  1446.  
  1447.        As with configuration keywords, the backslash ('\') is used as
  1448.      an escape-character for the following character, which is then
  1449.      just sent out unchanged. For example, if you need to send AT~Z4
  1450.      to your modem, use 
  1451.  
  1452.           AT\~Z4| 
  1453.  
  1454.        If you put this command into the configuration file, beware
  1455.      that the backslash needs to be escaped there. So you would have
  1456.      to use 
  1457.  
  1458.           MODEMINIT "AT\\~Z4|" 
  1459.  
  1460.      which gets even worse if you need to send a backslash to the
  1461.      modem. For example, some modems know commands such as AT\N0. In
  1462.      the configuration file, this looks like this: 
  1463.  
  1464.           MODEMINIT "AT\\\\N0|" 
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.      Configuration Commands                          Modem Commands
  1489.  
  1490.  
  1491.      Page 25             TrapDoor's Fourth Manual              Page 25
  1492.  
  1493.  
  1494.   4.3. Keywords     
  1495.  
  1496.   4.3.1. (NO)7WIRE     
  1497.  
  1498.        Enable/disable 7-wire cabling. This will instruct the serial
  1499.      device to use (or not to use) the CTS and RTS signals. If you
  1500.      are using high speed modems with data compression, such as a US
  1501.      Robotics Courier HST, you must use 7WIRE handshake and you must
  1502.      set your modem to "hardware handshake" mode, otherwise various
  1503.      difficulties will arise.  
  1504.  
  1505.      Examples: 7Wire 
  1506.                No7Wire 
  1507.  
  1508.   4.3.2. ABORT signals    
  1509.  
  1510.        Abort is the ARexx equivalent of ^C, ^D, ^E and ^F. To
  1511.      "simulate" such a keypress, just send an "ABORT k" message,
  1512.      where k can be any of C, D, E or F. Multiple signals are OK, ie.
  1513.      "ABORT CDEF" works as intended. For example, to terminate a
  1514.      TrapDoor that runs in answer mode, use "ABORT F".  
  1515.  
  1516.        (+) ARexx only command 
  1517.        (@) asynchronous execution possible (@ABORT) 
  1518.  
  1519.      Example: TrapTell "Abort F" 
  1520.  
  1521.   4.3.3. (NO)ABS     
  1522.  
  1523.        Enables/disables Automatic Buffer Sizing. If this is turned
  1524.      on, TrapDoor will try to reduce its CPU usage during Zmodem
  1525.      receiving. ABS has no effect whatsoever on
  1526.      Telink/DietIfna/Xmodem/FTS1 sessions, on the YooHoo or EMSI
  1527.      handshake or on Zmodem sending. It defaults to NOABS.  
  1528.  
  1529.      Examples: ABS 
  1530.                NoABS 
  1531.  
  1532.   4.3.4. (NO)ACCOUNTING     
  1533.  
  1534.        Turn accounting on or off. When enabled, TrapDoor will keep
  1535.      track of the number of calls made to a node, the total cost of
  1536.      all outgoing calls to that node, the number of calls received
  1537.      from that node, the number of successful and failed sessions as
  1538.      well as the number of calls that failed because of BUSY, NO
  1539.      CONNECTION or VOICE modem result strings.  
  1540.  
  1541.      Example: Accounting 
  1542.  
  1543.   4.3.5. ACCTMAX limits    
  1544.  
  1545.        When accounting is enabled, TrapDoor, when instructed to call
  1546.      a certain node, will check whether or not this node exceeds the
  1547.      accounting limits set by this keyword.  
  1548.  
  1549.  
  1550.      Configuration Commands                               Keywords
  1551.  
  1552.  
  1553.      Page 26             TrapDoor's Fourth Manual              Page 26
  1554.  
  1555.  
  1556.        The limits parameter, a single string enclosed in quotes, sets 
  1557.  
  1558.        - the maximum costs, 
  1559.        - the number of calls out, 
  1560.        - number of failed sessions (where a connection could be
  1561.          established, but the carrier was lost before the successful
  1562.          end of the session), 
  1563.        - number of "busy" results, 
  1564.        - number of "no connection/no carrier/no dialtone" results, 
  1565.        - number of "voice" results, 
  1566.  
  1567.      in that order. To disable a certain count, just set it to minus
  1568.      one.  
  1569.  
  1570.      Example: AcctMax "100 50 10 -1 -1 0" 
  1571.  
  1572.      sets the limits for further outgoing calls to 
  1573.  
  1574.        - Total cost thus far <= 100.  
  1575.        - Number of calls made <= 50.  
  1576.        - Number of failed sessions <= 10.  
  1577.        - Number of BUSY, NO CONNECTION doesn't matter.  
  1578.        - Number of VOICE <= 0 (ie. don't call when there was VOICE
  1579.          only once).  
  1580.  
  1581.   4.3.6. ADJUST factor    
  1582.  
  1583.        NOTE: the following explaination is only valid for AmigaOS up
  1584.      to 1.3. The serial device has been dramatically improved in
  1585.      AmigaOS 2.04. If you have AmigaOS 2.04 or higher, set ADJUST to
  1586.      zero or leave it out completely.  
  1587.  
  1588.        Unfortunately, the Amiga serial.device software has a small
  1589.      problem with baudrates: not only will it calculate the value to
  1590.      stuff into the baudrate register of the serial hardware
  1591.      incorrectly and therefore use baudrates that are a bit offset
  1592.      from the correct value, but also this behaviour is different on
  1593.      NTSC and PAL machines, which makes it even worse.  
  1594.  
  1595.        Some modems will work fine with such slightly wrong baudrates,
  1596.      others will not tolerate this and give a lot of transmission
  1597.      errors. By the way, this - it seems - is the main reason why
  1598.      programs such as BinkleyTerm Amiga fail to work with high-speed
  1599.      modems.  
  1600.  
  1601.        TrapDoor offers you a cure for such problems: ADJUST allows
  1602.      you to specify how much TrapDoor will vary any given baudrate
  1603.      before it passes it on to the serial.device. This value should
  1604.      be given in thousands (1/1000).  An example: at the default
  1605.      value of -11, a baudrate of 2400 will be adjusted to 2400-1.1% =
  1606.      2400-26.4 = 2373.6 baud. This value will be rounded to an
  1607.      integer and passed to the serial.device, which will then
  1608.      miscalculate the values for the hardware registers and set the
  1609.      hardware to almost exactly 2400 baud.  
  1610.  
  1611.  
  1612.      Configuration Commands                               Keywords
  1613.  
  1614.  
  1615.      Page 27             TrapDoor's Fourth Manual              Page 27
  1616.  
  1617.  
  1618.        Normally, you should leave this parameter at the default
  1619.      value. If you have a HST or similar buffering modem, you can try
  1620.      to set it to zero.  If you happen to live in the US (or any
  1621.      other country using 60 Hz video systems), you will probably have
  1622.      to set it to zero, or maybe even something else. Experiment! 
  1623.  
  1624.      Example: Adjust -11 
  1625.  
  1626.   4.3.7. AFTERSESSION command-string    
  1627.  
  1628.        As soon as TrapDoor finishes a FidoNet session with another
  1629.      mailer, and hangs up the modem, it will call the command you
  1630.      specify here. There may be embedded %-commands, which will be
  1631.      substituted by the parameters of the session that just ended; a
  1632.      list of them can be found in the chapter "Embedded
  1633.      Percent-Commands". To turn off the AFTERSESSION command, use
  1634.      AFTERSESSION "" or omit the statement completely.  
  1635.  
  1636.      Examples: AfterSession "run Execute Script:CheckInbound" 
  1637.                AfterSession "" 
  1638.  
  1639.   4.3.8. AKA akalist    
  1640.  
  1641.        During the EMSI handshake, not only your main address, but
  1642.      also a list of other "also-known-as" addresses will be sent to
  1643.      the other system. Using the AKA keyword, you can specify all
  1644.      your AKA addresses. <akalist> should be a single string, listing
  1645.      all your other addresses.  
  1646.  
  1647.        There is a limit of 20 AKAs for your system.  
  1648.  
  1649.      Example: Aka "2:3160/0 2:31/0 27:47/11" 
  1650.  
  1651.   4.3.9. (NO)ALLOWREFUSING     
  1652.  
  1653.        Enables (disables) AllowRefusing mode. Default is
  1654.      ALLOWREFUSING.  
  1655.  
  1656.        When AllowRefusing is enabled, TrapDoor respects the other
  1657.      end's wishes in the EMSI handshake. When the other end states it
  1658.      does not want to receive any compressed mail, for example,
  1659.      TrapDoor won't send it. With NoAllowRefusing, TrapDoor will
  1660.      always send what has to be sent.  
  1661.  
  1662.      Examples: AllowRefusing 
  1663.                NoAllowRefusing 
  1664.  
  1665.   4.3.10. ANSWER     
  1666.  
  1667.        Forces TrapDoor to operate in "answer mode". TD will then wait
  1668.      for a call, answer the phone and try to start a session with the
  1669.      remote system.  While in answer mode, TrapDoor will accept
  1670.      commands via its ARexx interface.  
  1671.  
  1672.  
  1673.  
  1674.      Configuration Commands                               Keywords
  1675.  
  1676.  
  1677.      Page 28             TrapDoor's Fourth Manual              Page 28
  1678.  
  1679.  
  1680.      Example: Answer 
  1681.  
  1682.   4.3.11. ARQSTRING string    
  1683.  
  1684.        Tells TrapDoor what string the modem returns when it connects
  1685.      to another modem under an error-control protocol. HST modems,
  1686.      for example, return the string "ARQ" as in "CONNECT
  1687.      9600/ARQ/HST/HST".  
  1688.  
  1689.        You must setup the correct ARQSTRING for your modem when you
  1690.      use FLOATLOCK and/or SNIFFARQ.  
  1691.  
  1692.      Example: ArqString "ARQ" 
  1693.  
  1694.   4.3.12. (NO)AUTOADJUST     
  1695.  
  1696.        When AutoAdjust is set, TrapDoor will try to move or resize
  1697.      its status and/or log window to make them fit on screen, should
  1698.      their position and/or size be inadequate for the screen on which
  1699.      TrapDoor opens.  This works only under KS 2.04 and higher.  The
  1700.      default is NoAutoAdjust.  
  1701.  
  1702.      Examples: AutoAdjust 
  1703.                NoAutoAdjust 
  1704.  
  1705.   4.3.13. (NO)AUTOOVERSCAN     
  1706.  
  1707.        When using the SCREENMODE CUSTOM, SCREENMODE TRAPDOOR or
  1708.      SCREENMODE PUBLIC option, switching this on forces TrapDoor to
  1709.      open its screen not to the standard NTSC or PAL size, but to the
  1710.      maximum size of the Workbench screen. If you use a program like
  1711.      "MoreRows" to expand your Workbench screen (under Kickstart
  1712.      1.2/1.3) or use extended Overscan settings under AmigaOS 2.04
  1713.      (or higher), and you would like TrapDoor to use the same
  1714.      expanded screen size, use this parameter.  
  1715.  
  1716.      Examples: AutoOverScan 
  1717.                NoAutoOverScan 
  1718.  
  1719.   4.3.14. (NO)BACKGROUND     
  1720.  
  1721.        When BACKGROUND is turned on, TrapDoor will open its screen
  1722.      behind all other screens. Also, when the log and status window
  1723.      are opened, they will not be activated, so your currently
  1724.      activated window will stay activated.  
  1725.  
  1726.   4.3.15. BANNER bannerline    
  1727.  
  1728.        This line will be sent to the other side when TrapDoor answers
  1729.      a call.  This typically identifies your system, says "hi", or
  1730.      tells human callers to hang up.  
  1731.  
  1732.        Instead of a single line, TrapDoor can also send a text file.
  1733.      In that case, use "<filename" as your BANNER (where filename
  1734.  
  1735.  
  1736.      Configuration Commands                               Keywords
  1737.  
  1738.  
  1739.      Page 29             TrapDoor's Fourth Manual              Page 29
  1740.  
  1741.  
  1742.      should indicate your banner file). Note that your banner file
  1743.      should not be too long. A few lines will suffice. TrapDoor will
  1744.      automatically convert LFs to CRLFs when sending the file.  
  1745.  
  1746.      Examples: Banner "TrapDoor Development, online 00:00-06:00" 
  1747.                Banner "<mail:banner.txt" 
  1748.  
  1749.   4.3.16. BAUD baudrate    
  1750.  
  1751.        This is the baudrate to initially talk to the modem -- after
  1752.      power-on or a reset. This speed may change during a session,
  1753.      when you did not lock the baud rate (see LOCK) and a different
  1754.      speed is reported by the modem.  
  1755.  
  1756.      Example: Baud 2400 
  1757.  
  1758.   4.3.17. BBSCHAR character    
  1759.  
  1760.        This option was included to allow for other "drop-to-the-BBS"
  1761.      keys, especially useful for users on machines that do not have
  1762.      an ESC key (some Macintosh models, C64). The ascii value you
  1763.      indicate here will be recognized and treated as if it were ESC,
  1764.      in addition to the ESC key.  
  1765.  
  1766.        There are three ways to specify the character: 
  1767.  
  1768.        - decimal ASCII code: just specify the decimal digits of the
  1769.          ASCII code 
  1770.        - hexadecimal ASCII code: use a dollar sign ("$") followed by
  1771.          the hexadecimal ASCII code 
  1772.        - the ASCII character itself: either prepend it with a single
  1773.          quote ("'"), or use just the character if it does not
  1774.          conflict with the other options (such as the dollar sign).  
  1775.  
  1776.      Examples: BBSChar 35 
  1777.                BBSChar $21 
  1778.                BBSChar ! 
  1779.                BBSChar '!' 
  1780.  
  1781.   4.3.18. BBSCOMMAND command-string    
  1782.  
  1783.        This is used to set the command line that TrapDoor will
  1784.      execute to start a BBS. There may be embedded %-commands, these
  1785.      are described in the chapter "Embedded Percent-Commands".  
  1786.  
  1787.        When a human caller presses ESC, the %-commands will be
  1788.      replaced with the corresponding value and then the resulting
  1789.      string will be executed.  
  1790.  
  1791.        BBSCOMMAND will only be used if the BBSMODE is set to SPAWN or
  1792.      EXIT.  
  1793.  
  1794.      Examples: BBSCommand "immed TR0 %b %B" 
  1795.                BBSCommand "uucico -r0" 
  1796.  
  1797.  
  1798.      Configuration Commands                               Keywords
  1799.  
  1800.  
  1801.      Page 30             TrapDoor's Fourth Manual              Page 30
  1802.  
  1803.  
  1804.   4.3.19. BBSINOUT device    
  1805.  
  1806.        This can be used to set stdin and stdout for the BBSCOMMAND to
  1807.      something else than those of the initial CLI from which TrapDoor
  1808.      was started. Just set it to any valid AmigaDOS device, like AUX: 
  1809.  
  1810.        To switch off this feature, use BBSINOUT "".  
  1811.  
  1812.      Example: BBSInOut AUX: 
  1813.  
  1814.   4.3.20. BBSMESSAGE text    
  1815.  
  1816.        With this keyword, you can override the standard messages that
  1817.      TrapDoor sends out just after the banner has been sent to a
  1818.      human caller. As you can see in the description of BBSMODE,
  1819.      TrapDoor will usually send a different message depending on the
  1820.      BBSMODE. Now you can override this message with the BBSMESSAGE
  1821.      command.  
  1822.  
  1823.        A text you set up with BBSMESSAGE will be in effect until
  1824.      another BBSMESSAGE command is sent to TrapDoor. Your BBSMESSAGE
  1825.      text will even stay active if you change BBSMODE. So don't
  1826.      forget to set up the right BBSMESSAGE in your (ARexx) scripts
  1827.      when you switch BBSMODE! 
  1828.  
  1829.        To re-establish the original behaviour (i.e. TrapDoor will
  1830.      automatically select a suitable text depending on the BBSMODE),
  1831.      use BBSMESSAGE "". This is also the default.  
  1832.  
  1833.      Examples: BBSMessage "Bitte druecken Sie zweimal Escape." 
  1834.                BBSMessage "This system is closed until 5:30." 
  1835.                BBSMessage "" 
  1836.  
  1837.   4.3.21. BBSMODE mode    
  1838.  
  1839.        There are four modes available for connecting a BBS to
  1840.      TrapDoor: 
  1841.  
  1842.           NONE ... There is no BBS, TrapDoor will display
  1843.                    "Mail only system -- please hang up" to
  1844.                    human callers.
  1845.  
  1846.           SPAWN .. TrapDoor will use the BBSCOMMAND setting
  1847.                    to start the BBS when a human caller
  1848.                    enters an ESC character. When the command
  1849.                    returns, TrapDoor will reinitialize the
  1850.                    modem and continue to wait for a call.
  1851.  
  1852.           EXIT ... TrapDoor will start the BBSCOMMAND just
  1853.                    as with SPAWN, but as soon as the command
  1854.                    returns, TrapDoor will exit.
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.      Configuration Commands                               Keywords
  1861.  
  1862.  
  1863.      Page 31             TrapDoor's Fourth Manual              Page 31
  1864.  
  1865.  
  1866.           ZMH .... There is a BBS, but at the moment, human
  1867.                    access to the BBS is closed due to
  1868.                    "Zone Mail Hour". TrapDoor will display
  1869.                    "Mail only period -- please call later"
  1870.                    to human callers.
  1871.  
  1872.      Examples: BBSMode Spawn 
  1873.                BBSMode None 
  1874.                BBSMode ZMH 
  1875.  
  1876.   4.3.22. (NO)BEEPDISPLAY     
  1877.  
  1878.        When BEEPDISPLAY is enabled (the default), TrapDoor will flash
  1879.      the screen when the modem sends a CONNECT message. You can
  1880.      disable this with NOBEEPDISPLAY.  
  1881.  
  1882.      Example: NoBeepDisplay 
  1883.  
  1884.   4.3.23. BOSS zone:net/node.point    
  1885.  
  1886.        Specifies the FidoNet address of your boss, as in "2:310/3".
  1887.      Please be careful as not to leave out the zone and point
  1888.      information when your boss node is capable of four dimensional
  1889.      addressing.  
  1890.  
  1891.        Note: the setting of BOSS also specifies what mail will be
  1892.      sent to the other system when you call out using a telephone
  1893.      number. So, if you are calling 2:310/3 with "TrapDoor call
  1894.      0043-1-454330" to request a file, you have to set BOSS to
  1895.      2:310/3 for that call, too.  
  1896.  
  1897.        Just to be on the safe side: if you are running a node, set
  1898.      this to your own address.  
  1899.  
  1900.      Example: Boss 2:310/6 
  1901.  
  1902.   4.3.24. CALL number | fido-address  
  1903.  
  1904.        Tells TrapDoor to call out. The number dialed can either be
  1905.      set in the configuration file with another CALL statement, or
  1906.      given directly in the command line: when the string following
  1907.      the CALL keyword is not BOSS, it will be interpreted as the
  1908.      number to call. Otherwise, the number from the configuration
  1909.      file will be used.  
  1910.  
  1911.        If you have enabled nodelist support (see NODELIST), you can
  1912.      also specify a FidoNet node number instead of the telephone
  1913.      number. Please note that you always have to prepend a zone
  1914.      number to the node number, as TrapDoor will use the
  1915.      zone-separating colon (":") to distinguish node numbers from
  1916.      phone numbers. When TrapDoor detects that you have given it a
  1917.      node number, it will consult the nodelist to find out the
  1918.      telephone number, the password and the baudrate (unless LOCKed)
  1919.      for that node and use these settings.  
  1920.  
  1921.  
  1922.      Configuration Commands                               Keywords
  1923.  
  1924.  
  1925.      Page 32             TrapDoor's Fourth Manual              Page 32
  1926.  
  1927.  
  1928.        Here are a few examples: 
  1929.  
  1930.        To call your boss using the telephone number and node number
  1931.      you have specified in the configuration file, use: 
  1932.  
  1933.           TrapDoor Call Boss 
  1934.  
  1935.        Note that you should have the statements 
  1936.  
  1937.           Call 12345678 Boss 2:310/6 
  1938.  
  1939.      somewhere in your config file.  
  1940.  
  1941.        To call another system that is not your boss, don't forget to
  1942.      change the BOSS keyword as well as other settings such as
  1943.      password, baud rate, etc.: 
  1944.  
  1945.           TrapDoor Call 87654321 Boss 2:310/3 Password "" 
  1946.  
  1947.        If you want to call a certain FidoNet node via the nodelist,
  1948.      just use 
  1949.  
  1950.           TrapDoor Call 2:310/3 
  1951.  
  1952.      and TrapDoor will figure out the password and other important
  1953.      configuration data for that node from the nodelist. Note that
  1954.      you have to have nodelist support enabled for this function to
  1955.      work (see NODELIST).  
  1956.  
  1957.      Examples: Call Boss 
  1958.                Call 0043-1-556-7854 
  1959.                Call 2:310/6 
  1960.  
  1961.        (@) asynchronous execution possible (@CALL) 
  1962.  
  1963.        @CALL can be used to trigger a call if this TrapDoor is not
  1964.      currently busy with another session. You can send TrapDoor the
  1965.      asynchronous @CALL command, and it will report either OUTGOING
  1966.      or INCOMING if it is already making or taking a call, or it will
  1967.      return the string CALLING if your @CALL statement is executing.
  1968.      So basically, @CALL is a combination of @STATUS S and a CALL
  1969.      command, but the operation is atomic. This is necessary for
  1970.      external schedulers.  
  1971.  
  1972.      Example: @Call 2:253/400 
  1973.  
  1974.   4.3.25. COLORS palette-specification    
  1975.   4.3.26. COLOURS palette-specification    
  1976.  
  1977.        When you use SCREENMODE CUSTOM, SCREENMODE TRAPDOOR or
  1978.      SCREENMODE PUBLIC (see SCREENMODE), you can change the colors
  1979.      with this option. The palette specifier looks rather like a
  1980.      window specification, starting with color 0 (the background
  1981.      color) and continuing to color 3. The value for each color is
  1982.  
  1983.  
  1984.      Configuration Commands                               Keywords
  1985.  
  1986.  
  1987.      Page 33             TrapDoor's Fourth Manual              Page 33
  1988.  
  1989.  
  1990.      given in decimal, using the formula 
  1991.  
  1992.          color = red * 256 + green * 16 + blue 
  1993.  
  1994.      where red, green and blue specify the intensity of each color (0
  1995.      is none, 15 is highest intensity). As an alternative, each value
  1996.      can also be given in hexadecimal notation, if prepended with a
  1997.      dollar sign ("$").  
  1998.  
  1999.        If you don't specify the colors yourself, TrapDoor will use
  2000.      the most stunning internal defaults.  
  2001.  
  2002.      Examples: Colours 2730/0/2560/10 
  2003.                Colors $aaa/$000/$a00/$00a 
  2004.  
  2005.   4.3.27. CONCEPTS     
  2006.  
  2007.        Display some ideas about the concepts of ShareWare. Also tells
  2008.      you how to register your copy of TrapDoor (and why to register).
  2009.      Read this! 
  2010.  
  2011.      Example: Concepts 
  2012.  
  2013.   4.3.28. CONFIG config-file    
  2014.  
  2015.        This is for people with a command-linophobia. It allows you to
  2016.      put yet another config file in your favorite config directory in
  2017.      addition to the standard "TrapDoor.cfg" that TrapDoor looks for.
  2018.      The format of such a file is just the same as that of the
  2019.      command line -- only that linefeeds will be ignored. Also, you
  2020.      may have comments embedded in the config file.  Just preceed
  2021.      them with a semicolon (";"), and TrapDoor will ignore the rest
  2022.      of the line starting at the semicolon.  
  2023.  
  2024.        Please note that several config files chaining one to the
  2025.      other are quite possible -- but you may have to increase your
  2026.      stack size when you have a try at this. Also note that a
  2027.      recursive config file (ie. calling itself) is a rather bad idea
  2028.      since you may not have set your stack size to plus infinity.  
  2029.  
  2030.      Example: Config Mail:TrapDoor.cfg 
  2031.  
  2032.   4.3.29. COST     
  2033.  
  2034.        This allows you to specify a default cost for calls. This cost
  2035.      will be in effect if you do not use a nodelist. This cost factor
  2036.      should be in units/min.  
  2037.  
  2038.        You can also use COST to allow calls to undialable nodes. Use
  2039.      a special config to set up the CALL and COST parameter, and your
  2040.      TrapDoor will be able to call that node. This is also explained
  2041.      in the chapter "Custom Configuration Entries".  
  2042.  
  2043.      Example: Cost 400 
  2044.  
  2045.  
  2046.      Configuration Commands                               Keywords
  2047.  
  2048.  
  2049.      Page 34             TrapDoor's Fourth Manual              Page 34
  2050.  
  2051.  
  2052.   4.3.30. CREDITS     
  2053.  
  2054.        Displays some "About" information. Read this first -- it will
  2055.      tell you a bit about this program and its authors.  
  2056.  
  2057.      Example: Credits 
  2058.  
  2059.   4.3.31. DIALER command-string    
  2060.  
  2061.        Use this if you have a custom dial-out program that will
  2062.      perform special PCP-dialing, for example. If a string other than
  2063.      "" has been specified and TrapDoor is about to call out, instead
  2064.      of sending a dial command to the modem, TrapDoor will call the
  2065.      external command. When the external program returns, TrapDoor
  2066.      will immediately start the session handshake, just as if the
  2067.      IMMEDIATE option had been used.  
  2068.  
  2069.        To turn off the special DIALER feature and use the built-in
  2070.      modem handling, use DIALER "" or omit the statement completely.
  2071.      There may be embedded %-commands, these are described in the
  2072.      chapter "Embedded Percent-Commands".  
  2073.  
  2074.      Examples: Dialer "callpcp" 
  2075.                Dialer "" 
  2076.  
  2077.   4.3.32. (NO)DIETIFNA     
  2078.  
  2079.        Enable (disable) DietIfna mode. Choose this, when you only
  2080.      transfer small files or when the line quality is rather poor
  2081.      since it might then be faster than ZModem.  
  2082.  
  2083.      Examples: NoDietIfna 
  2084.                DietIfna 
  2085.  
  2086.   4.3.33. (NO)DIRECTZAP     
  2087.  
  2088.        Enable (disable) DirectZap mode. DirectZap is a slight variant
  2089.      of the ZedZap transfer protocol, which is a slight variant of
  2090.      Zmodem -- on large files, this is the fastest protocol TrapDoor
  2091.      has to offer. Like ZedZap, DirectZap will automatically switch
  2092.      block sizes depending on modem speed and quality of the line. It
  2093.      will also resume an interrupted transfer if possible.  
  2094.  
  2095.        DirectZap only works in EMSI mode and only if the other side
  2096.      also supports it. Also, DirectZap only works on 8-bit
  2097.      transparent lines. You should disable it (use NODIRECTZAP) if
  2098.      you are working over a non-transparent line like a
  2099.      packet-switching network, for example.  
  2100.  
  2101.      Examples: NoDirectZap 
  2102.                DirectZap 
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.      Configuration Commands                               Keywords
  2109.  
  2110.  
  2111.      Page 35             TrapDoor's Fourth Manual              Page 35
  2112.  
  2113.  
  2114.   4.3.34. DROPBBSSECS seconds    
  2115.  
  2116.        When TrapDoor cannot detect a Fidonet handshake after
  2117.      DROPBBSSECS seconds, it will assume the caller is a human and
  2118.      pass the call to the BBS just as if the human had pressed Escape
  2119.      twice. You may not set DROPBBSSECS to anything lower than 10
  2120.      seconds. It defaults to 20 seconds.  
  2121.  
  2122.      Example: DropBBSSecs 45 
  2123.  
  2124.   4.3.35. (NO)DSR     
  2125.  
  2126.        After TrapDoor opens the serial.device, it will wait a short
  2127.      while (depending on SLOWMODEM) and then sample the DSR line.
  2128.      This line should be activated when a valid data set (i.e. a
  2129.      functioning modem) is connected to the serial line. If TrapDoor
  2130.      doesn't find DSR activated, it will report "! modem not ready"
  2131.      and abort.  
  2132.  
  2133.        There are a few modems that cannot properly handle DSR. For
  2134.      these modems, use the NODSR setting. Note that when using NODSR,
  2135.      TrapDoor can't tell whether the modem is powered-on, on-line and
  2136.      ready.  
  2137.  
  2138.        Also note that if you have not connected DSR to the modem (if
  2139.      you have a wrong/bad cable), RTS/CTS handshake might not work
  2140.      correctly. This is due to the way the Amiga serial.device
  2141.      handles things.  
  2142.  
  2143.      Examples: NoDsr 
  2144.                Dsr 
  2145.  
  2146.   4.3.36. (NO)EMSI     
  2147.  
  2148.        Turns the EMSI handshake on or off.  
  2149.  
  2150.        Note that the EMSI protocol is rather new. Although EMSI is
  2151.      designed to be backwards compatible to older mailers, some fail
  2152.      when presented an EMSI handshake packet. If you experience any
  2153.      session handshake failures with other mailers, try again with
  2154.      EMSI disabled (use the NOEMSI switch).  
  2155.  
  2156.        If you regularly call a node that cannot handle EMSI, you can
  2157.      set up a custom configuration string for that node. See the
  2158.      chapter "Custom Configuration Entries".  
  2159.  
  2160.      Examples: NoEmsi 
  2161.                Emsi 
  2162.  
  2163.   4.3.37. (NO)FASTEMSI     
  2164.  
  2165.        Per default, FASTEMSI is enabled and this is what TrapDoor has
  2166.      been doing all the time since it could do EMSI: immediately
  2167.      after the connect, it will try to detect whether the other
  2168.  
  2169.  
  2170.      Configuration Commands                               Keywords
  2171.  
  2172.  
  2173.      Page 36             TrapDoor's Fourth Manual              Page 36
  2174.  
  2175.  
  2176.      system can do EMSI, and if the other end indicates this, it will
  2177.      immediately start the handshake.  
  2178.  
  2179.        This "fast" variant of EMSI can however, under very rare
  2180.      circumstances, give problems. One of the things that might lead
  2181.      to problems are asterisks '*' in banner texts. If you call a
  2182.      system and repeatedly experience EMSI handshake failures, try
  2183.      turning off "fast" emsi with the NOFASTEMSI switch.  
  2184.  
  2185.        When fast EMSI is turned off, EMSI handshakes will be a little
  2186.      bit slower (about 1-2 secs).  
  2187.  
  2188.      Examples: FastEmsi 
  2189.                NoFastEmsi 
  2190.  
  2191.   4.3.38. FAXCOMMAND commandline    
  2192.  
  2193.        When TrapDoor detects a fax connect (it looks for FAXSTRING in
  2194.      messages from the modem), it will spawn this external program.
  2195.      Using this technique you can run your fax software to accept
  2196.      incoming fax calls while at the same time allowing ordinary
  2197.      modem callers to go to the bulletin board or to run a FidoNet
  2198.      session with your system. There may be embedded %-commands in
  2199.      the string, these are described in the chapter "Embedded
  2200.      Percent-Commands".  
  2201.  
  2202.        This will also work on outgoing calls. You can use the
  2203.      embedded percent command "d" to tell your fax software if this
  2204.      is an outgoing or incoming call.  
  2205.  
  2206.      Example: FaxCommand "Fax %d" 
  2207.  
  2208.   4.3.39. FAXSTRING string    
  2209.  
  2210.        Tells TrapDoor what string the modem returns when it connects
  2211.      to a fax machine or another fax modem using the fax protocol.
  2212.      Some fax modems, for example return the string "FAX" as in
  2213.      "CONNECT FAX"; others return "+FCON". You must setup the correct
  2214.      FAXSTRING for your modem when you use the FAXCOMMAND keyword.  
  2215.  
  2216.      Examples: FaxString "FAX" 
  2217.                FaxString "+FCON" 
  2218.  
  2219.   4.3.40. FKEY function-key-assignment    
  2220.  
  2221.        Assign a configuration command string to a function key. The
  2222.      keyword must be followed by a single string, starting with the
  2223.      number of the function key (F1=1, F2=2,...; Shift-F1=11,
  2224.      Shift-F2=12,...), followed by a colon (":"), followed by the
  2225.      assignment.  
  2226.  
  2227.        If you wish to include spaces in the assignment, the argument
  2228.      must be enclosed in double-quotes; to include quotes within the
  2229.      quoted string, use the backslash ("\") as an escape character.  
  2230.  
  2231.  
  2232.      Configuration Commands                               Keywords
  2233.  
  2234.  
  2235.      Page 37             TrapDoor's Fourth Manual              Page 37
  2236.  
  2237.  
  2238.      Examples: FKey "1:Emsi" 
  2239.                FKey "11:NoEmsi" 
  2240.                FKey "5:Call Boss" 
  2241.                FKey "6:Run CE" 
  2242.                FKey "7:Run \"Execute Scripts:Import\"" 
  2243.                FKey "8:Run \"TrapPoll +r\"" 
  2244.  
  2245.   4.3.41. (NO)FLOATLOCK     
  2246.  
  2247.        HST modems support a mode (&B2) in which they will drop the
  2248.      DTE baud rate (the baud rate used between modem and computer)
  2249.      when a connection is made without error-correction, but will
  2250.      keep the DTE baud rate locked on a connection with
  2251.      error-correction. FLOATLOCK allows you to use this mode.  
  2252.  
  2253.        If you have FLOATLOCK enabled, whenever TrapDoor reads a
  2254.      CONNECT xxx string from the modem, it will try to find the
  2255.      ARQSTRING string in the CONNECT result. If it finds it, it will
  2256.      keep the baudrate locked, otherwise it will switch to the
  2257.      baudrate found in the CONNECT string. You have to have LOCK
  2258.      enabled when you wish to use FLOATLOCK.  
  2259.  
  2260.        To turn off FLOATLOCK mode, use NOFLOATLOCK or omit the
  2261.      statement completely.  
  2262.  
  2263.        NOTE: we do not recommend using FLOATLOCK. Instead, set your
  2264.      HST to &B1 and S15=8. This can provide slightly higher troughput
  2265.      on non-ARQ connections than using &B2 and FLOATLOCK.  
  2266.  
  2267.      Examples: FloatLock 
  2268.                NoFloatLock 
  2269.  
  2270.   4.3.42. (NO)FORBID...     
  2271.  
  2272.        Select what type of mail/files you do _not_ want to be sent.
  2273.      In an EMSI handshake, TrapDoor will ask the remote system to not
  2274.      send these files (the other end may override this with the
  2275.      NOALLOWREFUSING switch): 
  2276.  
  2277.        - FORBIDXMAIL   Compressed mail and file attaches 
  2278.        - FORBIDFREQ    File requests 
  2279.        - FORBIDALL     All of the above 
  2280.  
  2281.      Examples: ForbidXMail 
  2282.                NoForbidFreq 
  2283.  
  2284.   4.3.43. FREQUEST command-string    
  2285.  
  2286.        Sets the command to be executed as a file-request server on
  2287.      received file requests from remote systems. There may be
  2288.      embedded %-commands, these are described in the chapter
  2289.      "Embedded Percent-Commands".  
  2290.  
  2291.        The called command should then read the remote's request from
  2292.  
  2293.  
  2294.      Configuration Commands                               Keywords
  2295.  
  2296.  
  2297.      Page 38             TrapDoor's Fourth Manual              Page 38
  2298.  
  2299.  
  2300.      the %i file, perform any action that it wants to do, and write a
  2301.      list of files that it wishes to send to the other side
  2302.      (including directory path) to the %o file.  
  2303.  
  2304.        To turn off the file-request capability, use FREQUEST "".  
  2305.  
  2306.        Please note that the answering of file-requests is disabled in
  2307.      unregistered versions of TrapDoor. The external file-request
  2308.      server will not be called.  
  2309.  
  2310.      Examples: FRequest "rx frequest %i,%o,%l" 
  2311.                FRequest "" 
  2312.  
  2313.   4.3.44. HELP     
  2314.  
  2315.        Output some descriptive text, explaining the usage and
  2316.      commandline syntax of TrapDoor.  
  2317.  
  2318.      Example: Help 
  2319.  
  2320.   4.3.45. (NO)IMMEDIATE     
  2321.  
  2322.        If you specify IMMEDIATE, TrapDoor will not care about modem
  2323.      commands, dialing, resetting the modem etc, but will go directly
  2324.      and immediately to the session handshake (EMSI, YooHoo or
  2325.      TSynch). So, if you have two Amigas connected via a serial
  2326.      cable, you can use TrapDoor to transfer files between them.  
  2327.  
  2328.        On the first machine, start TrapDoor with 
  2329.  
  2330.           TrapDoor ANSWER IMMEDIATE NODSR 
  2331.  
  2332.        TrapDoor will start up, open the serial device, ignore the DSR
  2333.      line (which has not been set high at that time because the other
  2334.      computer has not opened its serial device yet) and wait for
  2335.      approximately 30 seconds for a session handshake.  
  2336.  
  2337.        Now, on the other computer, run 
  2338.  
  2339.           TrapDoor CALL BOSS IMMEDIATE 
  2340.  
  2341.        TrapDoor will open its windows, and within a few seconds you
  2342.      should see the banner line of the other system appear in the
  2343.      status window. TrapDoor will then go on as usual with the
  2344.      session handshake and the actual file transfers.  
  2345.  
  2346.        IMMEDIATE has another use: if you send IMMEDIATE to a TrapDoor
  2347.      which is waiting in answer mode, it will react just as if it had
  2348.      just detected a RING from the modem. TrapDoor will send out the
  2349.      MODEMANSWER command and take an incoming call.  
  2350.  
  2351.      Example: Immediate 
  2352.  
  2353.  
  2354.  
  2355.  
  2356.      Configuration Commands                               Keywords
  2357.  
  2358.  
  2359.      Page 39             TrapDoor's Fourth Manual              Page 39
  2360.  
  2361.  
  2362.   4.3.46. INBOUND inbound-mail-directory    
  2363.  
  2364.        This should point to the directory where incoming files will
  2365.      be put.  Usually "Mail:Inbound". Make sure that the TrapDoor
  2366.      inbound directory is the same as the one for your mail tosser,
  2367.      or your attempts to import mail will fail miserably.
  2368.      Additionally, TrapDoor uses this directory for temporary files
  2369.      during receiving and for files that store information about
  2370.      aborted/interrupted file transfers, so that receiving these
  2371.      files can be resumed in the next ZedZap session. For more
  2372.      information, see chapter "Inbound Directory".  
  2373.  
  2374.      Examples: Inbound "Mail:Inbound" 
  2375.  
  2376.   4.3.47. (NO)INTERLACE     
  2377.  
  2378.        Specify whether TrapDoor should open its screen in the
  2379.      interlace mode or not.  
  2380.  
  2381.      Examples: NoInterlace 
  2382.                Interlace 
  2383.  
  2384.   4.3.48. (NO)KIWIPULSE     
  2385.  
  2386.        Applies a special number translation to the dial string before
  2387.      sending it to the modem. Special feature for kiwi people with
  2388.      vanilla modems.  
  2389.  
  2390.      Examples: NoKiwiPulse 
  2391.                KiwiPulse 
  2392.  
  2393.   4.3.49. (NO)LOCK     
  2394.  
  2395.        Lock (do not lock) the baudrate. If the baudrate is locked,
  2396.      and TrapDoor receives a "CONNECT XXXX" message from the modem,
  2397.      TrapDoor will not adjust the baud rate to XXXX, but continue to
  2398.      operate at the rate specified with the BAUD keyword. Use this
  2399.      for buffered modems that convert the baud rates internally (for
  2400.      example, HST). Be sure to also configure the modem for a locked
  2401.      baudrate in that case (i.e. on HSTs, use &B1).  
  2402.  
  2403.      Examples: NoLock 
  2404.                Lock 
  2405.  
  2406.   4.3.50. LOG level:text    
  2407.  
  2408.        Upon receipt of this ARexx command, TrapDoor will write the
  2409.      specified text with the specified log level to the log file.  
  2410.  
  2411.        (+) ARexx only command 
  2412.        (@) asynchronous execution possible 
  2413.            !!! not yet implemented !!! 
  2414.  
  2415.      Example: Log "3:Filerequest TRAPDOOR -> files:TD_1_50.LZH" 
  2416.  
  2417.  
  2418.      Configuration Commands                               Keywords
  2419.  
  2420.  
  2421.      Page 40             TrapDoor's Fourth Manual              Page 40
  2422.  
  2423.  
  2424.   4.3.51. LOGFILE filename    
  2425.  
  2426.        Sets the name of the logfile.  
  2427.  
  2428.      Example: Logfile "Mail:TrapDoor.Log" 
  2429.  
  2430.   4.3.52. LOGLEVEL group:level    
  2431.  
  2432.        Sets the amount of logging information to be put into the
  2433.      logfile.  There are ten logging groups, each of which deals with
  2434.      a different part of messages (such as modem, outbound, session
  2435.      protection, file transfers, general messages, external messages
  2436.      etc.). Each group maintains its own loglevel, which ranges from
  2437.      0 to 7. A list of all log messages together with their groups
  2438.      and levels can be found in the file "LogMsgs.doc".  
  2439.  
  2440.        The groups: 
  2441.  
  2442.          0  Debugger    ?  debugging messages, internal errors 
  2443.          1  Link        -  line is too bad, baudrate too low 
  2444.          2  Transfer    |  receiving xyz.txt, cps rates 
  2445.          3  System      !  deleting file xyz.txt, user break, out of
  2446.                            mem 
  2447.          4  Modem       ~  NO CARRIER, BUSY, RING, VOICE 
  2448.          5  Session     =  Begin of session, picking up mail, session
  2449.                            aborted, giving mail to, session connect
  2450.                            time, cost 
  2451.          6  Security    *  bad password, unlisted system, node is
  2452.                            undialable 
  2453.          7  Outside     x  spawning dialer, executing aftersession,
  2454.                            spawning bbs 
  2455.          8  Information :  sysop, name, aka, place, flags, using,
  2456.                            trxid 
  2457.          9  Scheduler   +  waiting for call, incoming call detected,
  2458.                            calling node 
  2459.  
  2460.        The levels: 
  2461.  
  2462.          0  Silent         minimum logging 
  2463.          1  Terse          terse logging 
  2464.          2  Discreet       normal logging 
  2465.          3  Verbose        detailed logging 
  2466.          4  Talkative      extensive logging 
  2467.          5  Excessive      very much logging 
  2468.          6  Annoying       even more logging 
  2469.          7  Monologue      maximum logging 
  2470.  
  2471.        Two (Discreet) seems to be a rather nice logging level and is
  2472.      the default for all groups. You might want to turn on more
  2473.      detailed logging in the Security and Information groups.  
  2474.  
  2475.      Examples: Loglevel 5:3 
  2476.                Loglevel 4:4 
  2477.  
  2478.  
  2479.  
  2480.      Configuration Commands                               Keywords
  2481.  
  2482.  
  2483.      Page 41             TrapDoor's Fourth Manual              Page 41
  2484.  
  2485.  
  2486.   4.3.53. LOGWINDOW window-specification    
  2487.  
  2488.        Use this keyword to change the position and size of the log
  2489.      window that TrapDoor opens. The window specification looks
  2490.      rather similar to a normal AmigaDOS CON:, RAW: or NEWCON:
  2491.      specification, but omit the device name and the window name. The
  2492.      correct format is: LeftEdge/TopEdge/Width/Height i.e. something
  2493.      like 0/20/640/150 
  2494.  
  2495.      Example: LogWindow 0/20/640/150 
  2496.  
  2497.   4.3.54. (NO)MAXBAUD     
  2498.  
  2499.        If turned on, the MINBAUD parameter will automatically be set
  2500.      to the baudrate of the called system (found in the nodelist) or
  2501.      the own baudrate (set with BAUD) on outgoing calls, whichever is
  2502.      lower.  
  2503.  
  2504.        What is this good for? Let us assume you have a 2400 baud
  2505.      modem, and you wish to call a node that is also capable of 2400
  2506.      baud. His nodelist entry also says he can do 2400 baud. Now, if
  2507.      you call him, sometimes, when line noise appears just when the
  2508.      modems negotiate the connect speed, this may cause a connection
  2509.      only at 1200 baud, or even worse, at 300 baud. If you have
  2510.      MAXBAUD enable, TrapDoor will immediately hang up in such a
  2511.      case.  
  2512.  
  2513.        On the other hand, if you are using an HST modem, and you are
  2514.      calling a system with a Trailblazer PEP modem, you might have
  2515.      problems when you use MAXBAUD: if the nodelist entry for the PEP
  2516.      modem specifies 9600 baud, TrapDoor will hang up if the connect
  2517.      speed is lower than 9600 baud. But: HST modems and PEP modems
  2518.      use a different high speed protocol and can only talk at 2400
  2519.      baud to each other. So, TrapDoor will hang up every time you
  2520.      call such a system.  
  2521.  
  2522.        You have to decide whether the usage of MAXBAUD is appropriate
  2523.      for you or not. You can also set up custom configuration entries
  2524.      to select specific MINBAUD values for selected nodes. See the
  2525.      chapter "Custom Configuration Entries" for more details.  
  2526.  
  2527.        Note: setconfig <node> NOMAXBAUD won't work. See the chapter
  2528.      "Bugs? Poof! They're all features!".  
  2529.  
  2530.      Examples: NoMaxBaud 
  2531.                MaxBaud 
  2532.  
  2533.   4.3.55. MAXLOGLINES number    
  2534.  
  2535.        This allows you to specify the number of log-lines that will
  2536.      be buffered, i.e. after so many lines have been written to the
  2537.      logfile, the file will be flushed (closed and reopened, in order
  2538.      to force all the data to disk).  
  2539.  
  2540.  
  2541.  
  2542.      Configuration Commands                               Keywords
  2543.  
  2544.  
  2545.      Page 42             TrapDoor's Fourth Manual              Page 42
  2546.  
  2547.  
  2548.        If you set this to 0, the behaviour is as in TrapDoor 1.80 and
  2549.      earlier (and this is also the default): the logfile will be
  2550.      flushed after every single line.  
  2551.  
  2552.      Example: MaxLogLines 5 
  2553.  
  2554.   4.3.56. MAXLOGSECS seconds    
  2555.  
  2556.        This specifies the number of seconds that may expire before
  2557.      TrapDoor will flush the logfile. It will actually flush it when
  2558.      the next line is written to the logfile.  
  2559.  
  2560.        If you set this to 0, the behaviour is as in TrapDoor 1.80 and
  2561.      earlier (and this is also the default): the logfile will be
  2562.      flushed after every single line.  
  2563.  
  2564.      Example: MaxLogSecs 7 
  2565.  
  2566.   4.3.57. MINBAUD baudrate    
  2567.  
  2568.        Minimal baudrate to establish a connection. Connections at
  2569.      baud rates below this limit will not be allowed, no matter if
  2570.      incoming or outgoing.  TrapDoor will hang up immediately if the
  2571.      baud rate is lower than the value specified.  
  2572.  
  2573.      Example: MinBaud 1200 
  2574.  
  2575.   4.3.58. MODEMANSWER modem-answer-string    
  2576.  
  2577.        Modem answer string like "AT~A|". For special characters like
  2578.      "~", "^" and "|" that are allowed in the string, see chapter
  2579.      "Modem Commands". The total length of the string may not exceed
  2580.      100 characters.  
  2581.  
  2582.        This string is sent to the modem whenever TrapDoor detects a
  2583.      "RING" and wants to answer the phone.  
  2584.  
  2585.      Example: ModemAnswer "ATA|" 
  2586.  
  2587.   4.3.59. MODEMDIALPRE modem-pre-dial-string    
  2588.  
  2589.        Modem dial string such as "AT~DP" or "AT~DT". For special
  2590.      characters like "~", "^" or "|" that are allowed in the string,
  2591.      see chapter "Modem Commands".  The total length of the string is
  2592.      limited to 100 characters.  
  2593.  
  2594.        This string is sent to the modem whenever TrapDoor wants to
  2595.      dial a number. After sending this string, TrapDoor will send the
  2596.      telephone number to dial, followed by the MODEMDIALPOST string.  
  2597.  
  2598.      Example: ModemDialPre "ATDP" 
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.      Configuration Commands                               Keywords
  2605.  
  2606.  
  2607.      Page 43             TrapDoor's Fourth Manual              Page 43
  2608.  
  2609.  
  2610.   4.3.60. MODEMDIALPOST modem-post-dial-string    
  2611.  
  2612.        Modem dial string such as "|". For special characters like
  2613.      "~", "^" and "|" that are allowed in the string, see chapter
  2614.      "Modem Commands".  The total length of the string is limited to
  2615.      20 characters.  
  2616.  
  2617.        This string is sent to the modem after the telephone number,
  2618.      when TrapDoor wants to dial a number. Also see the description
  2619.      of MODEMDIALPRE.  
  2620.  
  2621.      Example: ModemDialPost "|" 
  2622.  
  2623.   4.3.61. MODEMHANGUP modem-hangup-string    
  2624.  
  2625.        This string will be sent to the modem whenever TrapDoor wants
  2626.      to hang up the line. There are many methods to accomplish this,
  2627.      including the strange "~~~+++~~~ATH|" method. We do not
  2628.      recommend this. If you have configured your modem according to
  2629.      the descriptions in the chapter "The Modem", it should hang up
  2630.      as soon as DTR is lowered. So, the recommended hangup string is
  2631.      "|^|".  
  2632.  
  2633.        For special characters like "~", "^" and "|" that are allowed
  2634.      in the string, see chapter "Modem Commands". The total length of
  2635.      the string is limited to 40 characters.  
  2636.  
  2637.      Example: ModemHangup "|^|" 
  2638.  
  2639.   4.3.62. MODEMINIT modem-init-string    
  2640.  
  2641.        This string will be sent to the modem during the
  2642.      initialization phase of TrapDoor. Things like "AT~S7=20|" can be
  2643.      done here. For special characters like "~", "^" and "|" that are
  2644.      allowed in the string, see chapter "Modem Commands". The total
  2645.      length of the string is limited to 160 characters.  
  2646.  
  2647.        TrapDoor will also check if it gets any response from the
  2648.      modem after sending this init string. The modem should at least
  2649.      send something like "OK". In fact, any carriage-return
  2650.      terminated string from the modem will suffice.  
  2651.  
  2652.        If TrapDoor is unable to detect a response from the modem, it
  2653.      will report "Initializing modem failed" and exit.  
  2654.  
  2655.      Example: ModemInit "ATZ|" 
  2656.  
  2657.   4.3.63. NAME board's name   
  2658.  
  2659.        Name of this system -- to be sent to the other system during
  2660.      the beginning of a mail session. The length of the string is
  2661.      limited to 60 characters.  
  2662.  
  2663.      Example: Name "The Mad House -- TrapDoor Development" 
  2664.  
  2665.  
  2666.      Configuration Commands                               Keywords
  2667.  
  2668.  
  2669.      Page 44             TrapDoor's Fourth Manual              Page 44
  2670.  
  2671.  
  2672.   4.3.64. NODE zone:net/node.point    
  2673.  
  2674.        Sets your own FidoNet address.  
  2675.  
  2676.        For points: 
  2677.  
  2678.             If your boss uses a mailer that is not point smart, be
  2679.           sure to insert your private pointnet number here and not
  2680.           your full address. In this case, you should not use your
  2681.           complete four dimensional address (2:310/3.24), but rather
  2682.           the fake pointnet addressing method "2:3000/24".  
  2683.  
  2684.             FrontDoor, D'Bridge and newer versions of BinkleyTerm on
  2685.           the other hand do already support the four dimensional
  2686.           addressing method. Use your full address then.  
  2687.  
  2688.        For nodes: 
  2689.  
  2690.             Just set this to your own address.  
  2691.  
  2692.      Examples: Node 2:310/3.14 
  2693.                Node 2:310/6 
  2694.  
  2695.   4.3.65. NODELIST nodelist-directory    
  2696.  
  2697.        Set this to the directory where you keep your nodelist files.
  2698.      TrapDoor understands only nodelist files generated by its own
  2699.      nodelist processor, TrapList.  TrapDoor now uses the
  2700.      "traplist.library", which should be in your LIBS: directory, to
  2701.      access the nodelist.  
  2702.  
  2703.        To disable the nodelist support in TrapDoor, use NODELIST "".  
  2704.  
  2705.      Examples: Nodelist "Mail:Nodelist" 
  2706.                Nodelist "" 
  2707.  
  2708.   4.3.66. OUTBOUND outbound-mail-directory    
  2709.  
  2710.        This should point to the directory where outgoing files are
  2711.      kept. It should contain all the necessary #?.REQ, #?.FLO, #?.HLO
  2712.      and #?.CLO files and the associated mail bundles. TrapDoor will
  2713.      automatically maintain and delete these files as they get sent
  2714.      out. Usually set to "Mail:Outbound".  For more information, see
  2715.      chapter "Outbound directory".  
  2716.  
  2717.      Example: OutBound "Mail:Outbound" 
  2718.  
  2719.   4.3.67. PASSWORD password    
  2720.  
  2721.        Specifies the password to be used for mail sessions.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.      Configuration Commands                               Keywords
  2729.  
  2730.  
  2731.      Page 45             TrapDoor's Fourth Manual              Page 45
  2732.  
  2733.  
  2734.        On an outgoing call, if your password does not match the
  2735.      password that the other system has set up for you, you will be
  2736.      disconnected at the session handshake.  
  2737.  
  2738.        On incoming calls, if the password of the remote system does
  2739.      not match the password you specified here, this will be detected
  2740.      during the session handshake, recorded in the log file and the
  2741.      caller/callee will politely be shown the way out (i.e.
  2742.      disconnected).  
  2743.  
  2744.        If Nodelist support has been enabled by setting the NODELIST
  2745.      parameter, passwords will be fetched from there, unless the
  2746.      other system is not found in the nodelist.  
  2747.  
  2748.      Example: Password "secret" 
  2749.  
  2750.   4.3.68. PICKUP what    
  2751.  
  2752.        Select what mail and files to pickup (receive) from the remote
  2753.      system. These "Pickup Preferences" will only work if an EMSI
  2754.      handshake was used at the beginning of the session. There are
  2755.      three possible pickup values: 
  2756.  
  2757.        - ALL     Pick up mail and files for all of my addresses
  2758.                  (primary address + AKAs) 
  2759.        - PRIMARY Pick up mail and files for the primary address only 
  2760.        - NONE    Do not pick up mail or files at all 
  2761.  
  2762.      Examples: Pickup Primary 
  2763.                Pickup All 
  2764.                Pickup None 
  2765.  
  2766.   4.3.69. PUBSCREENNAME name    
  2767.  
  2768.        If you use SCREENMODE PUBLIC, this keyword allows you to
  2769.      specify the name of the public screen that TrapDoor should use.
  2770.      If a public screen with this name already exists, TrapDoor will
  2771.      open its windows there. If it does not exist, TrapDoor will open
  2772.      one.  
  2773.  
  2774.        Expert Notice: when TrapDoor opens the public screen, it will
  2775.      AllocVec() a buffer for the screen title. If any other program
  2776.      than TrapDoor closes the public screen, a few bytes of memory
  2777.      will be lost. If you are confused now and don't quite understand
  2778.      what I mean, just ignore it. :-) 
  2779.  
  2780.        PUBSCREENNAME defaults to "TrapDoor".  
  2781.  
  2782.      Example: PubScreenName "Hugo" 
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.      Configuration Commands                               Keywords
  2791.  
  2792.  
  2793.      Page 46             TrapDoor's Fourth Manual              Page 46
  2794.  
  2795.  
  2796.   4.3.70. QUIT     
  2797.  
  2798.        This tells TrapDoor to exit (when waiting in answer mode) and
  2799.      is exactly the same as "ABORT F" or pressing Alt-X or Alt-Q.  
  2800.  
  2801.        (+) ARexx only command 
  2802.        (@) asynchronous execution possible 
  2803.  
  2804.      Examples: Quit 
  2805.                @Quit 
  2806.  
  2807.   4.3.71. (NO)QUIET     
  2808.  
  2809.        If enabled, TrapDoor will run quietly in the background
  2810.      without opening any windows, screens etc. The logfile will still
  2811.      be written and you can still send ARexx commands to a TrapDoor
  2812.      running in QUIET mode.  
  2813.  
  2814.      Examples: NoQuiet 
  2815.                Quiet 
  2816.  
  2817.   4.3.72. REDIALDELAY seconds    
  2818.  
  2819.        This specifies the amount of time TrapDoor spends idling
  2820.      between calls to a system. Note that TrapDoor will not accept
  2821.      incoming calls while in "redial" state, so this option is only
  2822.      suited for points and will only work if you start TrapDoor with
  2823.      "TrapDoor Call ..." (i.e. you do not start it in answer mode).  
  2824.  
  2825.      Example: RedialDelay 120 
  2826.  
  2827.   4.3.73. RESET     
  2828.  
  2829.        This forces TrapDoor to reset/reinitialize the modem.  
  2830.  
  2831.        (+) ARexx only command 
  2832.  
  2833.      Example: Reset 
  2834.  
  2835.   4.3.74. RETRIES count    
  2836.  
  2837.        When calling a system, this instructs TrapDoor not to exit on
  2838.      a failed call (eg. line is busy), but to try it thus often
  2839.      again. Between the calls, TrapDoor will spend REDIALDELAY
  2840.      seconds waiting. Note that this automatic redialing does _not_
  2841.      apply if you place the call from within ANSWER mode. You have to
  2842.      start TrapDoor directly with the CALL parameter.  
  2843.  
  2844.      Example: Retries 5 
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.      Configuration Commands                               Keywords
  2853.  
  2854.  
  2855.      Page 47             TrapDoor's Fourth Manual              Page 47
  2856.  
  2857.  
  2858.   4.3.75. REXXNAME portname    
  2859.  
  2860.        Using this configuration keyword, you can select the ARexx
  2861.      port name (the "host address" in ARexx terminology) of TrapDoor.
  2862.      If you run TrapDoor on multiple lines, be sure to set up a
  2863.      different REXXNAME for every invocation. TrapDoor will not start
  2864.      up if the port name is already in use.  
  2865.  
  2866.      Example: RexxName "TrapDoor" 
  2867.  
  2868.   4.3.76. RINGCOMMAND commandline    
  2869.  
  2870.        This command will be spawned whenever TrapDoor detects a
  2871.      "RING" from the modem. When it returns, TrapDoor will answer the
  2872.      call (if RINGS "RING"s have passed). You can use it to trigger
  2873.      some sound effects, if you like.  
  2874.  
  2875.      Example: RingCommand "rx \"address upd play 12\"" 
  2876.  
  2877.   4.3.77. RINGINGS number    
  2878.  
  2879.        This is the number of times TrapDoor will allow another system
  2880.      to keep the phone "ringing" on an outgoing call. TrapDoor
  2881.      increments a counter every time it receives the string "RINGING"
  2882.      or "RRING" from your modem. When the counter exceeds the number
  2883.      specified with RINGINGS, TrapDoor will hang up, report the call
  2884.      as "NO ANSWER", and account it as an unanswered call (similar to
  2885.      "NO CARRIER").  
  2886.  
  2887.      Example: Ringings 3 
  2888.  
  2889.   4.3.78. RINGS number    
  2890.  
  2891.        Number of rings to wait before answering an incoming call. To
  2892.      turn off the answering feature, you can set this to any
  2893.      high-enough value (RINGS 5000 will probably never answer the
  2894.      phone).  
  2895.  
  2896.      Example: Rings 1 
  2897.  
  2898.   4.3.79. RUN command-string    
  2899.  
  2900.        Causes TrapDoor to execute the given command asynchronously.
  2901.      If the command includes spaces, it must be enclosed in
  2902.      double-quotes; to include quotes within the quoted string, use
  2903.      the backslash ("\") as an escape character. Embedded Percent
  2904.      Commands can also be used here.  
  2905.  
  2906.        TrapDoor will not wait until the command returns, but merely
  2907.      continue to process ARexx messages and answer incoming calls.
  2908.      This is the big difference to the SPAWN keyword. In fact, "Run
  2909.      XXX" is exactly the same as "SPAWN \"Run XXX\"".  
  2910.  
  2911.        (+) ARexx only command 
  2912.  
  2913.  
  2914.      Configuration Commands                               Keywords
  2915.  
  2916.  
  2917.      Page 48             TrapDoor's Fourth Manual              Page 48
  2918.  
  2919.  
  2920.      Examples: Run "ed mail:TrapDoor.cfg" 
  2921.                Run "echo \"This command was started from TrapDoor.\"" 
  2922.  
  2923.   4.3.80. SCLEAR     
  2924.  
  2925.        This command will clear the serial (receive) buffer.  
  2926.  
  2927.        (+) ARexx only command 
  2928.  
  2929.      Example: SClear 
  2930.  
  2931.   4.3.81. SCREENMODE mode    
  2932.  
  2933.        This allows you to specify the screen where TrapDoor opens its
  2934.      windows.  There are five possible modes: 
  2935.  
  2936.           WORKBENCH -- TrapDoor will open its windows on the
  2937.         workbench screen.  
  2938.  
  2939.           CUSTOM -- TrapDoor will open its own screen and place the
  2940.         windows there.  
  2941.  
  2942.           TRAPDOOR -- Similar to CUSTOMSCREEN, TrapDoor will open its
  2943.         windows on its own screen. However, if you have multiple
  2944.         TrapDoors running at the same time, all invocations of
  2945.         TrapDoor will share the same "TrapDoor" screen. The screen
  2946.         will only close when the last copy of TrapDoor quits
  2947.         running.  
  2948.  
  2949.           PUBLIC -- Similar to TRAPDOOR, but will use a Kickstart
  2950.         2.04 Public Screen instead of the proprietary and
  2951.         undocumented method that SCREENMODE TRAPDOOR uses. Thus,
  2952.         other programs can open their windows on the public TrapDoor
  2953.         screen, too. Or you can also make TrapDoor open its windows
  2954.         on a foreign public screen if you use SCREENMODE PUBLIC in
  2955.         conjunction with PUBSCREENNAME (to define the name of the
  2956.         public screen that TrapDoor should use).  
  2957.  
  2958.           ACTIVE -- TrapDoor will use the screen with the currently
  2959.         active window and open its windows there. Note that this is
  2960.         rather dangerous as TrapDoor cannot control when the other
  2961.         program will close the screen. If this happens, TrapDoor will
  2962.         try to write to a screen that no longer exists and this will
  2963.         in most cases immediately crash the machine.  
  2964.  
  2965.           In spite of these restrictions, SCREENMODE ACTIVE looks
  2966.         very nice in conjunction with Chameleon, a wonderful message
  2967.         editor written by Jürgen Hermann. Try sticking the following
  2968.         command into your 'CE.CFG' file: 
  2969.  
  2970.                 External CustomScreen "Call Boss" \ 
  2971.                         "TrapDoor call boss screenmode active" 
  2972.  
  2973.           Now start Chameleon, pull down the "External" menu, select
  2974.  
  2975.  
  2976.      Configuration Commands                               Keywords
  2977.  
  2978.  
  2979.      Page 49             TrapDoor's Fourth Manual              Page 49
  2980.  
  2981.  
  2982.         this item and see for yourself ...  
  2983.  
  2984.      Examples: ScreenMode Workbench 
  2985.                ScreenMode TrapDoor 
  2986.  
  2987.   4.3.82. SERIALFLAGS serial-flags    
  2988.  
  2989.        If you use some other device than "serial.device", you might
  2990.      need to change this, too. Consult the documentation that came
  2991.      with your other device or use zero as default.  
  2992.  
  2993.      Example: SerialFlags 0 
  2994.  
  2995.   4.3.83. SERIALNAME serial-device-name    
  2996.  
  2997.        If you happen to have a modem connected to some other device
  2998.      than the standard Amiga "serial.device", you can use this
  2999.      parameter to set up the correct device name. Usually,
  3000.      "serial.device" will just be about perfect.  For Supra 2400zi
  3001.      modems, use SERIALNAME "modem0.device".  
  3002.  
  3003.      Example: SerialName "serial.device" 
  3004.  
  3005.   4.3.84. SERIALUNIT serial-unit-number    
  3006.  
  3007.        If your modem is connected to some other unit number than zero
  3008.      (on the device you set with SERIALNAME), change this
  3009.      appropriately.  
  3010.  
  3011.      Example: SerialUnit 0 
  3012.  
  3013.   4.3.85. (NO)SHARED     
  3014.  
  3015.        (Don't) Open the serial device in shared mode. If you are
  3016.      running TrapDoor in conjunction with a BBS program or similar,
  3017.      you need to switch the serial device to SHARED mode, so that
  3018.      both programs can have it open at the same time.  
  3019.  
  3020.      Examples: NoShared 
  3021.                Shared 
  3022.  
  3023.   4.3.86. (NO)SHOWREXX     
  3024.  
  3025.        In SHOWREXX mode, TrapDoor will display all ARexx commands
  3026.      that it processes in the status window.  
  3027.  
  3028.        You can toggle showrexx mode from the keyboard using Alt-S.  
  3029.  
  3030.      Examples: NoShowRexx 
  3031.                ShowRexx 
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.      Configuration Commands                               Keywords
  3039.  
  3040.  
  3041.      Page 50             TrapDoor's Fourth Manual              Page 50
  3042.  
  3043.  
  3044.   4.3.87. SLINE     
  3045.  
  3046.        This command will receive one line of text from the serial
  3047.      port and return it in the ARexx RESULT variable. The timeout
  3048.      specified with STIMEOUT will be used.  
  3049.  
  3050.        (+) ARexx only command 
  3051.  
  3052.      Example: SLine 
  3053.  
  3054.   4.3.88. SLOWMODEM modem-command-delay    
  3055.  
  3056.        Some modems won't understand incoming data at full speed while
  3057.      in command mode. Others take some time after a reset (ATZ or DTR
  3058.      dropped) until they will react to incoming commands again. If
  3059.      your modem doesn't seem to understand the commands TrapDoor is
  3060.      trying to send, feel free to change (increase) this parameter.
  3061.      Also see chapter "The Modem" for some suggested values.  
  3062.  
  3063.        SLOWMODEM changes a number of timings in TrapDoor, the most
  3064.      important being: 
  3065.  
  3066.        (a) the time that TrapDoor waits between lowering and raising
  3067.            of DTR when it tries to reset the modem or hang up, 
  3068.  
  3069.        (b) the time that TrapDoor waits when it encounters a tilde
  3070.            ("~") character in a modem command string (MODEMINIT,
  3071.            MODEMDIAL, MODEMANSWER).  
  3072.  
  3073.      Example: SlowModem 7 
  3074.  
  3075.   4.3.89. SMODEM modem-command    
  3076.  
  3077.        This ARexx-only command will send a command to the modem. It
  3078.      is similar to SWRITE, but the specified string will be run
  3079.      through the modem command processor first, allowing the use of
  3080.      "~", "^" and "|" special characters. For more information about
  3081.      these characters, see chapter "Modem Commands".  
  3082.  
  3083.        (+) ARexx only command 
  3084.  
  3085.      Example: SModem "~~AT~H1|~~" 
  3086.  
  3087.   4.3.90. (NO)SNIFFARQ     
  3088.  
  3089.        If you have a modem that will detect MNP, LAP-M, V42 and
  3090.      similar error-correction protocols, you can enable SNIFFARQ.
  3091.      With SNIFFARQ, TrapDoor will minimize session-startup delays.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.      Configuration Commands                               Keywords
  3101.  
  3102.  
  3103.      Page 51             TrapDoor's Fourth Manual              Page 51
  3104.  
  3105.  
  3106.        The default is NOSNIFFARQ. You should _not_ use SNIFFARQ with
  3107.      modems that have no error correction. You must specify the
  3108.      correct ARQSTRING for your modem if you use SNIFFARQ.  
  3109.  
  3110.      Examples: NoSniffArq 
  3111.                SniffArq 
  3112.  
  3113.   4.3.91. SPAWN command-string    
  3114.  
  3115.        Causes TrapDoor to execute the given command. If the command
  3116.      includes spaces, it must be enclosed in double-quotes; to
  3117.      include quotes within the quoted string, use the backslash ("\")
  3118.      as an escape character. Embedded Percent Commands can also be
  3119.      used here.  
  3120.  
  3121.        TrapDoor will wait until the command returns. It will not
  3122.      execute any other ARexx commands, nor will it answer incoming
  3123.      calls while the command is executing.  
  3124.  
  3125.        (+) ARexx only command 
  3126.  
  3127.      Examples: Spawn "ed mail:TrapDoor.cfg" 
  3128.                Spawn "echo \"Spawned from TrapDoor!\"" 
  3129.  
  3130.   4.3.92. STARTSESSION     
  3131.  
  3132.        When TrapDoor receives this command, it will immediately start
  3133.      waiting for a banner line from the remote system, then begin
  3134.      with the session handshake.  
  3135.  
  3136.        This command is intended to be used in outdialing scripts as
  3137.      the final command, giving control to TrapDoor to begin a
  3138.      session.  
  3139.  
  3140.        (+) ARexx only command 
  3141.  
  3142.      Example: StartSession 
  3143.  
  3144.   4.3.93. STATUS what    
  3145.  
  3146.        Depending on the argument, this command will return various
  3147.      information about the state TrapDoor is in, the result of
  3148.      previous calls etc.  
  3149.  
  3150.        The following status specifiers are recognized: 
  3151.  
  3152.        C ... Returns the cost of the last call made.  
  3153.  
  3154.        D ... Reports the result string of the dial (or call), such as
  3155.              BUSY, NO DIALTONE.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.      Configuration Commands                               Keywords
  3163.  
  3164.  
  3165.      Page 52             TrapDoor's Fourth Manual              Page 52
  3166.  
  3167.  
  3168.        F ... Reports the number of files that have been sent and
  3169.              received during the last session, separated by a slash
  3170.              ('/').  
  3171.  
  3172.        S ... Reports the serial status of TrapDoor, which indicates
  3173.              whether TrapDoor is currently waiting for a call,
  3174.              answering a call or making an outgoing call. Valid
  3175.              return values are: 
  3176.  
  3177.              IDLE:     TrapDoor is idle, waiting for a call
  3178.              OUTGOING: TrapDoor is making an outgoing call
  3179.              INCOMING: TrapDoor is answering an incoming call
  3180.  
  3181.        X ... Queries the status of the last transfer. It returns an
  3182.              integer number, where: 
  3183.  
  3184.              0: everything okay
  3185.              1: (internal) unused
  3186.              2: protocol error (too many retries)
  3187.              3: (internal) end-of-transmission, Telink complete
  3188.              4: (internal) file skipped
  3189.              5: user break (Ctrl-C or ESC)
  3190.              6: carrier lost
  3191.              7: disk i/o error
  3192.              8: remote canceled transmission
  3193.              9: internal program error
  3194.              10: human caller detected
  3195.              11: remote didn't answer
  3196.              12: (internal) object in use, can't send
  3197.  
  3198.        (+) ARexx only command 
  3199.        (@) asynchronous execution possible 
  3200.  
  3201.      Examples: Status D 
  3202.                @Status S 
  3203.  
  3204.   4.3.94. STATWINDOW window-specification    
  3205.  
  3206.        Similar to LOGWINDOW, this changes the position and size of
  3207.      the status window.  
  3208.  
  3209.      Example: StatWindow 30/155/580/37 
  3210.  
  3211.   4.3.95. STIMEOUT timeout    
  3212.  
  3213.        Sets the timeout, in seconds, for the SWAIT and SLINE
  3214.      commands.  
  3215.  
  3216.      Example: STimeout 3 
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.      Configuration Commands                               Keywords
  3225.  
  3226.  
  3227.      Page 53             TrapDoor's Fourth Manual              Page 53
  3228.  
  3229.  
  3230.   4.3.96. SWAIT string    
  3231.  
  3232.        Waits until the given string is received on the serial line,
  3233.      or until the timeout set with STIMEOUT has expired.  
  3234.  
  3235.      Example: SWait "login:" 
  3236.  
  3237.   4.3.97. (NO)SWEPULSE     
  3238.  
  3239.        Applies a special number translation to the dial string before
  3240.      sending it to the modem. Special feature for swedish people with
  3241.      non-swedish modems.  
  3242.  
  3243.      Examples: NoSwePulse 
  3244.                SwePulse 
  3245.  
  3246.   4.3.98. SWRITE string    
  3247.  
  3248.        Sends the given string to the modem. The string will be sent
  3249.      as given, without any modification.  
  3250.  
  3251.      Example: SWrite "Mad Max" 
  3252.  
  3253.   4.3.99. SYSOP sysop's-name    
  3254.  
  3255.        Sysop's name, will be sent to the other system during session
  3256.      negotiation. The length of this string is limited to 20
  3257.      characters in the YooHoo/WaZoo handshake and to 30 characters
  3258.      when using EMSI.  
  3259.  
  3260.      Example: Sysop "Maximilian Hantsch" 
  3261.  
  3262.   4.3.100. TASKPRI priority    
  3263.  
  3264.        Use this to select the AmigaDOS/Exec task priority of
  3265.      TrapDoor. Normal tasks operate at priority 0. It is often
  3266.      advisable to set the priority of TrapDoor to 1 or 2, so that
  3267.      mail sessions are not slowed down by other activity such as mail
  3268.      importing/exporting.  
  3269.  
  3270.        If the keyword is not used, TrapDoor will run at the priority
  3271.      of the invoking process.  
  3272.  
  3273.      Example: TaskPri 1 
  3274.  
  3275.   4.3.101. TESTFREQ     
  3276.  
  3277.        To be able to test your file request server programs and
  3278.      scripts, call TrapDoor with "TrapDoor testfreq". This will cause
  3279.      TrapDoor to look for a TrapDoor.FReq file in the inbound
  3280.      directory and, if one is found, call the file request server
  3281.      (specified with the FREQUEST keyword). The result of the file
  3282.      request server should be a .RLO file in your outbound directory,
  3283.      which you can check to see whether everything works all right.  
  3284.  
  3285.  
  3286.      Configuration Commands                               Keywords
  3287.  
  3288.  
  3289.      Page 54             TrapDoor's Fourth Manual              Page 54
  3290.  
  3291.  
  3292.         Please note that the request file should be called
  3293.      "TrapDoor.FReq", or to be more exact,
  3294.      "<name-of-your-arexx-port>.FReq".  
  3295.  
  3296.      Example: TestFreq 
  3297.  
  3298.   4.3.102. (NO)TIMESTAMP     
  3299.  
  3300.        If TIMESTAMP is switched on, TrapDoor will always use
  3301.      timestamps for converting 4D echomail bundle names to 2D for
  3302.      sending. Note: this might be incompatible with some old Echomail
  3303.      tossers when they are switched to "check security" mode.  
  3304.  
  3305.        If NOTIMESTAMP is in effect (the default), TrapDoor will try
  3306.      to use the standard hex net/node difference naming, unless: 
  3307.  
  3308.        - either system has a point address.  
  3309.        - the main addresses of the two systems are in different
  3310.          zones, but have the same net and node numbers.  
  3311.  
  3312.                    "Fidonet peculiarities? Don't worry,
  3313.                    we got them all under control... ;-)"
  3314.  
  3315.      Examples: NoTimeStamp 
  3316.                TimeStamp 
  3317.  
  3318.   4.3.103. (NO)UNLISTEN     
  3319.  
  3320.        Make TrapDoor terminate all its serial I/O. It will still keep
  3321.      the serial device open, but not send any I/O requests to it.
  3322.      TrapDoor will keep hanging around idle until you send it a
  3323.      NOUNLISTEN ARexx message. If you tell TrapDoor to make an
  3324.      outgoing call, it will do so, but return to its silent UNLISTEN
  3325.      state as soon as the call is over.  
  3326.  
  3327.      Examples: UnListen 
  3328.                NoUnListen 
  3329.  
  3330.   4.3.104. (NO)WAZOO     
  3331.  
  3332.        Enable (disable) WaZoo mode. With WaZoo disabled, TrapDoor
  3333.      will only attempt to connect using the FTS-0001 (Lotek) protocol
  3334.      or EMSI handshake. No YooHoo will be done.  
  3335.  
  3336.      Examples: NoWaZOO 
  3337.                WaZOO 
  3338.  
  3339.   4.3.105. (NO)WRAPLINES     
  3340.  
  3341.        With WrapLines enabled, TrapDoor will try to wrap lines that
  3342.      are sent to the log window and continue them in the next line,
  3343.      if they are too long to be displayed on a single line. The
  3344.      logfile will be unaffected by the setting of this switch. Only
  3345.      the output in the window is reformatted.  
  3346.  
  3347.  
  3348.      Configuration Commands                               Keywords
  3349.  
  3350.  
  3351.      Page 55             TrapDoor's Fourth Manual              Page 55
  3352.  
  3353.  
  3354.      Examples: WrapLines 
  3355.                NoWrapLines 
  3356.  
  3357.   4.3.106. (NO)XMAIL     
  3358.  
  3359.        Enable (disable) eXtended Mail, whatever that is. There is a
  3360.      flag in the EMSI handshake packet called "XMA". The EMSI
  3361.      documentation is very unclear about what it means. Anyway, you
  3362.      got the choice now :-) 
  3363.  
  3364.        This keyword defaults to XMAIL, as this was the behaviour of
  3365.      TrapDoor 1.80.  
  3366.  
  3367.      Examples: NoXMail 
  3368.                XMail 
  3369.  
  3370.   4.3.107. (NO)ZEDZAP     
  3371.  
  3372.        Enable (disable) ZedZap mode. ZedZap is a slight variant of
  3373.      the ZModem transfer protocol -- on large files, this is one of
  3374.      the fastest protocols around. ZedZap will automatically switch
  3375.      block sizes depending on modem speed and quality of the line. It
  3376.      will also resume an interrupted transfer if possible.  
  3377.  
  3378.        ZedZap only works in WaZoo or EMSI mode and only if the other
  3379.      side also supports it.  
  3380.  
  3381.      Examples: NoZedZap 
  3382.                ZedZap 
  3383.  
  3384.   4.3.108. (NO)ZEDZIP     
  3385.  
  3386.        Enable (disable) ZedZip mode. ZedZip is the ZModem transfer
  3387.      protocol -- it will not switch block sizes, but use a fixed
  3388.      block size of 1kb. It will resume an interrupted transfer if
  3389.      possible.  
  3390.  
  3391.        ZedZip only works in WaZoo or EMSI mode and only if the other
  3392.      side also supports it.  
  3393.  
  3394.      Examples: NoZedZip 
  3395.                ZedZip 
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.      Configuration Commands                               Keywords
  3411.  
  3412.  
  3413.      Page 56             TrapDoor's Fourth Manual              Page 56
  3414.  
  3415.  
  3416.   5. Example Setup    
  3417.  
  3418.           ; ****************************************************
  3419.           ; **                                                **
  3420.           ; **    TrapDoor 1.83 Example Configuration File    **
  3421.           ; **                                                **
  3422.           ; ****************************************************
  3423.  
  3424.           ; This is my FidoNet node number
  3425.  
  3426.           NODE 2:310/6.0
  3427.  
  3428.           ; here are my AKAs
  3429.  
  3430.           AKA "2:3160/0 7:123/456 13:13/42"
  3431.  
  3432.           ; This is my node's name
  3433.  
  3434.           NAME "The Mad House -- TrapDoor Development"
  3435.  
  3436.           ; This is the sysop's name
  3437.  
  3438.           SYSOP "Maximilian Hantsch"
  3439.  
  3440.           ; Point setup: set up the password for your boss node here.
  3441.           ; Leave this unset ("") to operate a node or set it to
  3442.           ; something else to not accept calls from unlisted nodes.
  3443.  
  3444.           PASSWORD ""
  3445.  
  3446.           ; Here I set up the baudrate that TrapDoor should use to
  3447.           ; talk to the modem
  3448.  
  3449.           BAUD 19200
  3450.  
  3451.           ; For modems that can lock the baudrate, use LOCK.
  3452.  
  3453.           LOCK
  3454.  
  3455.           ; This is the minimum baudrate at which TrapDoor will
  3456.           ; keep a connection. If the modem responds with a
  3457.           ; "CONNECT xxx" message where xxx is lower than
  3458.           ; the MINBAUD value, TrapDoor will hang up.
  3459.  
  3460.           MINBAUD 300
  3461.  
  3462.           ; Point setup: set this to your boss' FidoNet address.
  3463.           ; Set this to your own address when running a node.
  3464.  
  3465.           BOSS 2:310/6.0
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.      Example Setup
  3473.  
  3474.  
  3475.      Page 57             TrapDoor's Fourth Manual              Page 57
  3476.  
  3477.  
  3478.           ; Point setup: set this to the telephone number of your
  3479.           ; boss. When operating with a nodelist, you can also put
  3480.           ; the FidoNet address of your boss here and TrapDoor will
  3481.           ; consult the nodelist to find out the phone number.
  3482.           ; Note that TrapDoor uses the colon (":") in the FidoNet
  3483.           ; node number ot distinguish it from a telephone number,
  3484.           ; so always specify the zone if you want to give it a
  3485.           ; nodenumber.
  3486.  
  3487.           CALL 2:310/6
  3488.  
  3489.           ; The path to your outbound directory where .FLO, .OUT
  3490.           ; and such stuff is.
  3491.  
  3492.           OUTBOUND "Mail:Outbound"
  3493.  
  3494.           ; The path to your inbound directory where incoming files
  3495.           ; are put.
  3496.  
  3497.           INBOUND "Mail:Inbound"
  3498.  
  3499.           ; If you specify a path here, TrapDoor will use this
  3500.           ; directory to find nodelist index/extra files.
  3501.           ; To disable nodelist support, use NODELIST "".
  3502.  
  3503.           NODELIST "NodeList:"
  3504.  
  3505.           ; Use MAXBAUD to automatically adjust MINBAUD to the
  3506.           ; highest possible baudrate.
  3507.  
  3508.           MAXBAUD
  3509.  
  3510.           ; This is the number of rings that TrapDoor will wait
  3511.           ; before answering the phone. If you don't want TrapDoor
  3512.           ; to answer the phone, just set this to RINGS 9999.
  3513.  
  3514.           RINGS 1
  3515.  
  3516.           ; A banner line that will be displayed to human callers.
  3517.           ; Instead of specifying a string, you could also send out
  3518.           ; a complete banner file here. The second line gives you
  3519.           ; an example of that.
  3520.  
  3521.           BANNER "TrapDoor Development, online Mon-Sun 00:00-06:00"
  3522.           ; BANNER "<mail:Banner"
  3523.  
  3524.           ; This is the commandline that TrapDoor will execute when
  3525.           ; a user presses Escape to enter the BBS.
  3526.           ; To disable the BBS, use BBSMODE NONE or leave it out.
  3527.  
  3528.           ; BBSCOMMAND "DLG:immed TR0 %b %B -w"
  3529.           ; BBSINOUT ""
  3530.           ; BBSMODE SPAWN
  3531.  
  3532.  
  3533.  
  3534.      Example Setup
  3535.  
  3536.  
  3537.      Page 58             TrapDoor's Fourth Manual              Page 58
  3538.  
  3539.  
  3540.           ; In addition to the Escape key, you can specify another
  3541.           ; character that users can press twice to enter the BBS.
  3542.           ; WARNING: Do not use an asterisk ('*') here!
  3543.  
  3544.           ; BBSCHAR '.'
  3545.  
  3546.           ; This defines the name of the logfile for TrapDoor.
  3547.  
  3548.           LOGFILE "Mail:TrapDoor.Log"
  3549.  
  3550.           ; Here are the loglevels for various logging groups.
  3551.  
  3552.           LOGLEVEL 0:2            ; debugger
  3553.           LOGLEVEL 1:2            ; link
  3554.           LOGLEVEL 2:2            ; transfer
  3555.           LOGLEVEL 3:2            ; system
  3556.           LOGLEVEL 4:2            ; modem
  3557.           LOGLEVEL 5:2            ; session
  3558.           LOGLEVEL 6:7            ; security
  3559.           LOGLEVEL 7:2            ; outside
  3560.           LOGLEVEL 8:7            ; information
  3561.           LOGLEVEL 9:2            ; scheduler
  3562.  
  3563.           ; I want faster logging.
  3564.  
  3565.           MAXLOGSECS 5
  3566.           MAXLOGLINES 10
  3567.  
  3568.           ; If you have a "slow" modem, set this to higher values.
  3569.  
  3570.           SLOWMODEM 10
  3571.  
  3572.           ; MODEMINIT     will be sent to the modem to reset it.
  3573.           ; MODEMDIALPRE  will be sent to the modem to dial out,
  3574.           ;               followed by the phone number, followed by
  3575.           ; MODEMDIALPOST
  3576.           ; MODEMANSWER   will be sent to answer the phone.
  3577.           ; MODEMHANGUP   will be sent to hangup the modem.
  3578.  
  3579.           MODEMINIT "~~ATZ|~~~~"
  3580.           MODEMHANGUP "||^|"
  3581.           MODEMDIALPRE "~~ATS7=60B1X7DP"
  3582.           MODEMDIALPOST "|"
  3583.           MODEMANSWER "~~ATS7=25B0A|"
  3584.  
  3585.           ; If your modem is an error correcting modem, ARQSTRING
  3586.           ; tells TrapDoor what the modem returns when it
  3587.           ; establishes a connection under error control. If you
  3588.           ; have such a modem, you can also specify SNIFFARQ and
  3589.           ; handshakes can become a bit faster.
  3590.  
  3591.           ; ARQSTRING "ARQ"
  3592.           ; SNIFFARQ
  3593.  
  3594.  
  3595.  
  3596.      Example Setup
  3597.  
  3598.  
  3599.      Page 59             TrapDoor's Fourth Manual              Page 59
  3600.  
  3601.  
  3602.           ; This informs TrapDoor which Amiga device is your
  3603.           ; serial device. For example, a Supra 2400zi modem
  3604.           ; needs SERIALNAME "modem0.device".
  3605.  
  3606.           SERIALNAME "serial.device"
  3607.           SERIALUNIT 0
  3608.           SERIALFLAGS 0
  3609.  
  3610.           ; If you want to spawn a BBS, you must use the SHARED
  3611.           ; option. Otherwise, you can use NOSHARED to prevent
  3612.           ; other programs from using the serial device when
  3613.           ; TrapDoor has it open.
  3614.  
  3615.           SHARED
  3616.  
  3617.           ; If your modem does not support the DSR line, use NODSR.
  3618.           ; Otherwise, use DSR and TrapDoor will be able to tell
  3619.           ; whether your modem is switched on or not.
  3620.  
  3621.           DSR
  3622.  
  3623.           ; If you have a buffering modem, you need to have a full
  3624.           ; 7-wire cable and enable hardware handshaking with 7WIRE.
  3625.  
  3626.           7WIRE
  3627.  
  3628.           ; Please read TrapDoor's manual for a more detailed
  3629.           ; explanation of the ADJUST parameter. If you are not
  3630.           ; sure what to do with it, leave it at -11.
  3631.           ; If you have AmigaOS 2.0 or higher, use ADJUST 0 or
  3632.           ; leave it out completely.
  3633.  
  3634.           ;ADJUST -11
  3635.  
  3636.           ; This tells TrapDoor what command to execute to handle
  3637.           ; incoming File Requests. Please consult the manual for
  3638.           ; a more detailed description.
  3639.           ; To turn off File Requests, use FREQUEST "".
  3640.  
  3641.           FREQUEST "RequestHandler %i,%o,%l"
  3642.  
  3643.           ; This is the name of TrapDoor's ARexx port.
  3644.           ; If you have multiple lines, you need to change this
  3645.           ; for each line.
  3646.  
  3647.           REXXNAME "TrapDoor"
  3648.  
  3649.           ; Where should TrapDoor put its windows?
  3650.           ; Note that on NTSC machines and their smaller screens,
  3651.           ; you will have to change the value of STATWINDOW.
  3652.  
  3653.           LOGWINDOW 30/15/580/133
  3654.           STATWINDOW 30/155/580/93
  3655.           ; STATWINDOW 30/155/580/44 ; use this on NTSC
  3656.  
  3657.  
  3658.      Example Setup
  3659.  
  3660.  
  3661.      Page 60             TrapDoor's Fourth Manual              Page 60
  3662.  
  3663.  
  3664.           ; Use SCREENMODE CUSTOM to have TrapDoor open its own
  3665.           ; screen, SCREENMODE WORKBENCH to have it open its
  3666.           ; windows on the Workbench Screen, SCREENMODE ACTIVE
  3667.           ; to open the windows on the currently active screen,
  3668.           ; and SCREENMODE TRAPDOOR for special magic.
  3669.           ; If you have AmigaOS 2.04, you might also want to
  3670.           ; try SCREENMODE PUBLIC.
  3671.           ; Beware: Please read the instructions in the manual
  3672.           ; before using SCREENMODE ACTIVE.
  3673.  
  3674.           SCREENMODE TRAPDOOR
  3675.  
  3676.           ; If you want TrapDoor to open its screen in the
  3677.           ; background, use BACKGROUND.
  3678.           ; To have it open the screen to the same size your
  3679.           ; Workbench Screen has (including overscan set with
  3680.           ; MoreRows), use AUTOOVERSCAN.
  3681.           ; If you don't want any screens or windows, use
  3682.           ; QUIET.
  3683.  
  3684.           NOBACKGROUND
  3685.           AUTOOVERSCAN
  3686.           ; QUIET
  3687.  
  3688.           ; For a nice colorful TrapDoor screen, change this as
  3689.           ; desired.
  3690.  
  3691.           COLORS 2560/4095/10/160
  3692.  
  3693.           ; Point setup: If a call to your boss fails (BUSY,
  3694.           ; VOICE, NO CARRIER ...), you can use these keywords
  3695.           ; to have TrapDoor redial automatically after a
  3696.           ; certain amount of time. Use RETRIES to set the maximum
  3697.           ; number of retries and REDIALDELAY to specify the number
  3698.           ; of seconds to wait between calls.
  3699.  
  3700.           RETRIES 0
  3701.           REDIALDELAY 3
  3702.  
  3703.           ; Enable accounting with ACCOUNTING and specify
  3704.           ; accounting limits. The template for ACCTMAX is:
  3705.           ; ACCTMAX "cost calls-out failed busy nocarrier voice"
  3706.  
  3707.           ACCOUNTING
  3708.           ACCTMAX "3000 20 2 20 5 2"
  3709.  
  3710.           ; Node systems: If you want your TrapDoor to automatically
  3711.           ; start in answer mode when you just "run TrapDoor",
  3712.           ; specify ANSWER
  3713.  
  3714.           ; ANSWER
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.      Example Setup
  3721.  
  3722.  
  3723.      Page 61             TrapDoor's Fourth Manual              Page 61
  3724.  
  3725.  
  3726.           ; Some function key assignments
  3727.  
  3728.           FKey "1:EMSI"
  3729.           FKey "11:NOEMSI"
  3730.           FKey "2:WAZOO"
  3731.           FKey "12:NOWAZOO"
  3732.           FKey "3:ZEDZAP ZEDZIP DIRECTZAP"
  3733.           FKey "13:NOZEDZAP NOZEDZIP NODIRECTZAP"
  3734.           FKey "4:DIETIFNA"
  3735.           FKey "14:NODIETIFNA"
  3736.           FKey "5:BBSMODE SPAWN"
  3737.           FKey "15:BBSMODE ZMH"
  3738.           FKey "6:Run \"CE\""
  3739.           FKey "16:Run \"FFSA Node 2:310/6 ActiveScreen\""
  3740.           FKey "7:Run \"Execute DLGConfig:Batch/UnPackMail\""
  3741.           FKey "17:SMODEM |~ATH1|~~~~~~~~~~~~~~~~~|~ATH0|~"
  3742.           FKey "8:Run \"Execute DLGConfig:Batch/PackMail\""
  3743.           FKey "18:Run \"Execute DLGConfig:Batch/NComm.batch\""
  3744.           FKey "9:Run \"Execute DLGConfig:Batch/Poll\""
  3745.           FKey "19:acctmax \"-1 -1 -1 -1 -1 -1\""
  3746.           FKey "10:Run \"local\""
  3747.           FKey "20:Run \"getport -p tr0:\""
  3748.  
  3749.           ; NOTE: Not all possible configuration keywords are used
  3750.           ;       in this example configuration. Please see the
  3751.           ;       chapter "Configuration Commands" for a more
  3752.           ;       detailed and more complete description of
  3753.           ;       TrapDoor's configuration.
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.      Example Setup
  3783.  
  3784.  
  3785.      Page 62             TrapDoor's Fourth Manual              Page 62
  3786.  
  3787.  
  3788.   6. The Outbound Directory   
  3789.  
  3790.        The outbound directory stores packet files (#?.OUT, #?.CUT,
  3791.      #?.DUT, #?.HUT), file attach files (#?.FLO, #?.CLO, #?.DLO,
  3792.      #?.HLO) and request files (#?.REQ).  
  3793.  
  3794.        TrapDoor uses two different methods of naming these files.
  3795.      First, there are the "compatibility" names for compatibility
  3796.      with existing packers.  Second, there are full 4-dimensional
  3797.      filenames for hopefully soon-to-come new packers that want to
  3798.      make use of full 4-dimensional FidoNet addressing.  
  3799.  
  3800.   6.1. 'Compatibility' Filenames    
  3801.  
  3802.        The first eight characters of the filename indicate the net
  3803.      and node number for which this file is designated. These numbers
  3804.      are encoded in hexadecimal and expanded to 4 digits each
  3805.      (leading zeros).  
  3806.  
  3807.        Zone and Point information is not included in these filenames.
  3808.      This is a major disadvantage, but unfortunately all current mail
  3809.      Scanners/Tossers for the Amiga only support this format.  
  3810.  
  3811.   6.2. 4-dimensional Filenames    
  3812.  
  3813.        This release of TrapDoor continues our quest for a new method
  3814.      of naming files in the outbound directory. It understands
  3815.      "4-dimensional" filenames "zone.net.node.point.ext", with all
  3816.      fields in decimal. This naming scheme is still under discussion
  3817.      -- use it for now, it works, but it might be changed again in
  3818.      future releases.  
  3819.  
  3820.   6.3. Extensions     
  3821.  
  3822.        File extensions tell TrapDoor how to treat a certain file.  
  3823.  
  3824.   6.4. Packet files    
  3825.  
  3826.        These files contain packed mail (Note: not compressed
  3827.      (ARC)mail). This is often used for matrix mail, as these packets
  3828.      are easily built and matrix mail normally doesn't get so large
  3829.      that it needs compression. They are sent 'as is' to the other
  3830.      system. During the transfer, the name of such a file is changed
  3831.      to "abcdefgh.PKT", where "abcdefgh" is a unique 8-digits
  3832.      hexadecimal number (in fact, a timestamp).  
  3833.  
  3834.           #?.OUT ... Normal, meaning that this packet hasn't been
  3835.                      processed further.  If left unprocessed, it will
  3836.                      be treated the same as a .DUT packet.  
  3837.           #?.HUT ... Hold this packet for pickup by the remote
  3838.                      system.  
  3839.           #?.CUT ... The other system can receive Continuous Mail.  
  3840.           #?.DUT ... Direct, meaning the other system can NOT receive
  3841.                      Continuous Mail.  
  3842.  
  3843.  
  3844.      The Outbound Directory                            Packet files
  3845.  
  3846.  
  3847.      Page 63             TrapDoor's Fourth Manual              Page 63
  3848.  
  3849.  
  3850.   6.5. Flow files    
  3851.  
  3852.        Files are also sent through FidoNet. File attach files tell
  3853.      TrapDoor what files to send (or hold) for whom. File attach
  3854.      files are also called 'flow files' after the .FLO file
  3855.      extension.  
  3856.  
  3857.        Flow files store the path and name of files that should be
  3858.      sent to the other system. Each line in the flow file refers to
  3859.      one file. Additionally, there may be one of the following
  3860.      special characters at the first position in the line, indicating
  3861.      that the file needs special processing after sending.  
  3862.  
  3863.        Valid special characters: 
  3864.  
  3865.           # ... Truncate this file to zero length
  3866.           ^ ... Delete this file (with logging)
  3867.           - ... Delete this file (without logging)
  3868.           ~ ... Don't send this file (has been sent previously)
  3869.  
  3870.        Examples: 
  3871.  
  3872.           DH0:Files/outgoing/special/sendme.zoo
  3873.           t:trapdoor.zoo
  3874.           #MAIL:Outbound/FFEB0034.MO1
  3875.           -t:delete.me
  3876.  
  3877.        Flow file extensions are: 
  3878.  
  3879.           #?.FLO ... Normal, meaning that this flow file hasn't been
  3880.                      processed further. If left unprocessed, it will
  3881.                      be treated the same as a .DLO flow file.  
  3882.           #?.HLO ... Hold these files for pickup by the remote
  3883.                      system.  
  3884.           #?.CLO ... The other system can receive Continuous Mail.  
  3885.           #?.DLO ... Direct, meaning the other system can NOT receive
  3886.                      Continuous Mail.  
  3887.  
  3888.   6.6. Compressed Mail files   
  3889.  
  3890.        These files are not automatically sent. Their names must be
  3891.      listed in one of the #?.?LO files. Usually, the filename of
  3892.      these files follows a 2-dimensional naming method: The first 4
  3893.      hex digits contain the difference between the net numbers of the
  3894.      originating and the destination system, the second 4 hex digits
  3895.      the difference between the node numbers.  
  3896.  
  3897.        The extension of compressed mail files is built of the first
  3898.      two digits of the name of a weekday, i.e. MO, TU, WE, TH, FR, SA
  3899.      or SU, plus one decimal digit to prevent duplicates, for
  3900.      example, "MO3" or "FR0".  
  3901.  
  3902.        TrapDoor 1.70 and higher now also support 4-dimensional
  3903.      compressed mail bundles. These are named just like the other
  3904.  
  3905.  
  3906.      The Outbound Directory                    Compressed Mail files
  3907.  
  3908.  
  3909.      Page 64             TrapDoor's Fourth Manual              Page 64
  3910.  
  3911.  
  3912.      4-dimensional files, with the same extension as their
  3913.      2-dimensional counterpart, for example "2.310.6.4.TU3". The
  3914.      names of 4-dimensional compressed mail files must be listed in
  3915.      #?.?LO files, just as with their 2D counterpart.  
  3916.  
  3917.   6.7. Request files    
  3918.  
  3919.        These files are sent to the other system 'as is' for further
  3920.      processing. Each line in these files contain the name of a file
  3921.      you'd like to request from the other system and possibly,
  3922.      following a space and an exclamation mark, a password for the
  3923.      file.  
  3924.  
  3925.        Example: 
  3926.  
  3927.           FILES
  3928.           TRAPDOOR.ZOO
  3929.           SECRET.ARC !ILBM
  3930.  
  3931.   6.8. Examples     
  3932.  
  3933.           0136000b.out ... a normal mail packet for 310/11 
  3934.           01360003.clo ... a file attach file for 310/3, will be sent
  3935.                            as continuous mail 
  3936.           0136000c.hlo ... a file attach file, held for pickup by
  3937.                            310/12 
  3938.  
  3939.        Or, using the new 4-dimensional naming scheme: 
  3940.  
  3941.           1.163.109.0.hut ... a normal mail packet, held for pickup
  3942.                               by 1:163/109 
  3943.           2.310.6.5.dlo ..... a direct file attach file for 2:310/6.5 
  3944.           2.310.6.4.MO2 ..... a compressed mail bundle for 2:310/6.4 
  3945.           2.246.3.0.req ..... a request file for 2:246/3 
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.      The Outbound Directory                               Examples
  3969.  
  3970.  
  3971.      Page 65             TrapDoor's Fourth Manual              Page 65
  3972.  
  3973.  
  3974.   7. The Inbound Directory   
  3975.  
  3976.        The inbound directory stores all files received from other
  3977.      systems.  TrapDoor does not associate inbound filenames with a
  3978.      certain meaning, this is left for the Scanner/Tosser software
  3979.      (i.e. TrapToss, ConfMail).  
  3980.  
  3981.        TrapDoor currently manages the inbound directory filenames &
  3982.      filenotes like this: 
  3983.  
  3984.         <filename> := <msdos_filename>
  3985.                       '!.' <msdos_filename> '.' <fido_adr>
  3986.         <fido_adr> := <zone> '.' <net> '.' <node> '.' <point>
  3987.         <zone>     := integer
  3988.         <net>      := integer
  3989.         <node>     := integer
  3990.         <point>    := integer
  3991.  
  3992.         <filenote> := <field> <field> ...
  3993.         <field>    := <tag> ' ' <contents> '; '
  3994.         <tag>      := anything_except_space
  3995.         <contents> := anything_except_semicolon
  3996.  
  3997.         Currently defined tags are:
  3998.  
  3999.              FileName
  4000.              From
  4001.              Length
  4002.              Secure
  4003.              Trx
  4004.  
  4005.        When a file comes in, it is received under a temporary
  4006.      filename. When the file has been received successfully, it is
  4007.      renamed to the final filename.  Should a file with this name
  4008.      already exist, TrapDoor does the usual filename bumping (see
  4009.      "Bumping Filenames"), but stores the original filename in the
  4010.      filenote in a "FileName" field. Additionally, each inbound file
  4011.      is tagged with a "From" field in the filenote.  
  4012.  
  4013.        When a file transfer fails (carrier lost etc.), the temporary
  4014.      file is renamed to "!.filename.zz.nnn.ooo.pp", where <filename>
  4015.      is the original filename, and <zz.nnn.ooo.pp> is the FidoNet
  4016.      address of the sender. These files are also tagged with a
  4017.      "FileName" field in the FileNote. Additionally, TrapDoor adds a
  4018.      "Length" field to the FileNote, which specifies how long the
  4019.      file should be.  
  4020.  
  4021.        When TrapDoor begins to receive a new file, it tries to find a
  4022.      "!.filename.zz.nnn.ooo.pp" file that matches the incoming file.
  4023.      If such a file exists, and the filesize compares successfully
  4024.      (remember: "Length" tag in the filenote!), TrapDoor will resume
  4025.      transfer (ZedZap sessions) at the end of the file. FTS-1 and
  4026.      DietIfna can't resume transfer, but you can abort such a file
  4027.      transfer and later on resume with ZedZap.  
  4028.  
  4029.  
  4030.      The Inbound Directory
  4031.  
  4032.  
  4033.      Page 66             TrapDoor's Fourth Manual              Page 66
  4034.  
  4035.  
  4036.        When TrapDoor resumes receiving a file, it will first rename
  4037.      it to a temporary filename again and clear the filenote. Further
  4038.      actions are taken as described above.  
  4039.  
  4040.        The "Secure" tag stores the security measures under which a
  4041.      file was received. Files received from systems listed in the
  4042.      nodelist get the "NL" flag, and files received during
  4043.      password-protected sessions are marked "PW". Both flags can be
  4044.      set if a file was received from a listed system in a
  4045.      password-protection session, in which case they will be
  4046.      separated by a comma (",").  
  4047.  
  4048.        The "Trx" tag is used to store the Transaction ID of the
  4049.      session in which the file was received. Every session, or
  4050.      "transaction" with another system is associated with a unique
  4051.      identifier, the "transaction id". This identifier is also listed
  4052.      in the logfile as "TrxID". A transaction id consists of one
  4053.      single hexadecimal number, plus possibly a slash and another
  4054.      hexadecimal number giving the transaction id which the remote
  4055.      system associated with this particular transaction. The latter
  4056.      is only shown if the other end sent us their transaction id,
  4057.      which can only happen in an EMSI handshake.  
  4058.  
  4059.        Please note that the order of the filenote fields is
  4060.      insignificant.  
  4061.  
  4062.        Examples: 
  4063.  
  4064.           Normal inbound file, received from a known node with
  4065.           password-protection:
  4066.                ffeb0034.mo1
  4067.                : From 2:310/3; Secure NL,PW; Trx 27b23ba7;
  4068.  
  4069.           Bumped inbound file:
  4070.                ffeb0034.mo1,1
  4071.                : From 2:310/3; FileName ffeb0034.mo1; Trx 27c138f7/27c138fb;
  4072.  
  4073.           Aborted transfer:
  4074.                !.ffeb0034.mo1.2.310.3.0
  4075.                : FileName ffeb0034.mo1; Length 23862; Trx 27c139ae;
  4076.  
  4077.        This format should be rather flexible if future extensions
  4078.      have to be added (limit is 80 chars for all the filenote
  4079.      fields), but still remains totally compatible with ConfMail &
  4080.      other utilities that assume MS-Dos style filenames.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.      The Inbound Directory
  4093.  
  4094.  
  4095.      Page 67             TrapDoor's Fourth Manual              Page 67
  4096.  
  4097.  
  4098.   7.1. Bumping Filenames    
  4099.  
  4100.        TrapDoor does not overwrite inbound files. Instead, the
  4101.      incoming filename is "bumped", i.e. a unique name is created by
  4102.      cautiously modifying the original filename until a new, unique
  4103.      name is found.  
  4104.  
  4105.        Bumping proceeds like this: 
  4106.  
  4107.        (a) If the filename matches "#?.?UT", it is renamed to a
  4108.            random "#?.PKT" file. This is necessary, as some MS-Dos
  4109.            software does not rename .OUT files into .PKT when
  4110.            transmitting them with the DietIfna protocol. Therefore,
  4111.            TrapDoor tries to correct this mistake. After this step,
  4112.            bumping continues at (b). [00bf13f4.OUT -> 27bc34f5.PKT] 
  4113.  
  4114.        The following steps will only be performed as long as the name
  4115.        is not unique, i.e. as long as there exists already a file
  4116.        with that name.  
  4117.  
  4118.        (b) If the filename matches "#?.PKT", it is given some random
  4119.            hexadecimal number plus the ".PKT" extension again. Thus,
  4120.            packet files stay packet files, even when bumped. Only if
  4121.            a unique name cannot be found within ten tries, method (d)
  4122.            is used for renaming the file. [27bc34f5.PKT ->
  4123.            28c39d7f.PKT] 
  4124.  
  4125.        (c) If the filename matches
  4126.            "#?.(MO|TU|WE|TH|FR|SA|SU)([0-9])", the very last digit of
  4127.            the filename is modified. If a unique name cannot be found
  4128.            by changing the last digit, method (d) is used.
  4129.            [00bf3f55.mo0 -> 00bf3f55.mo1] 
  4130.  
  4131.        (d) If the filename is not unique, TrapDoor will append a
  4132.            comma (",") and a number. The number will be incremented
  4133.            as long as the name is not unique. [test.txt -> test.txt,1
  4134.            -> test.txt,2 -> etc.] 
  4135.  
  4136.        (e) continue at (d) until a unique name is found.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.      The Inbound Directory                        Bumping Filenames
  4155.  
  4156.  
  4157.      Page 68             TrapDoor's Fourth Manual              Page 68
  4158.  
  4159.  
  4160.   8. Bugs? Poof! They're all features! 
  4161.  
  4162.        Most problems we have encountered are caused by wrong or
  4163.      incomplete RS232 cabling, modem settings, and last, but not
  4164.      least, people not reading the documentation. Be sure to
  4165.      especially examine the chapter about the modem carefully if you
  4166.      encounter problems.  
  4167.  
  4168.        There is a minor inconvenience for people using NTSC Amigas:
  4169.      You have to change the default setting of STATWINDOW, as this
  4170.      window won't open on a standard non-interlaced NTSC screen.  
  4171.  
  4172.        If you find that you have trouble communicating with another
  4173.      Fidonet system, you might try using different protocols.
  4174.      Experiment with the (NO)EMSI, (NO)WAZOO, (NO)DIRECTZAP,
  4175.      (NO)ZEDZAP, (NO)ZEDZIP and (NO)WAZOO keywords.  
  4176.  
  4177.        (NO)MAXBAUD does not have any effect if used in custom
  4178.      configuration entries (set via setconfig). You need to set a
  4179.      MINBAUD value instead. So, instead of 
  4180.  
  4181.           setconfig 2:310/6 "NOMAXBAUD"     ; WRONG! 
  4182.      use 
  4183.           setconfig 2:310/6 "MINBAUD 2400"  ; much better.  
  4184.  
  4185.        TrapDoor usually runs with the standard 4000 bytes stack size.
  4186.      Should you experience strange hangups, crashes or Guru
  4187.      Meditations, try raising the stack size with the CLI command
  4188.      "Stack" before running TrapDoor.  
  4189.  
  4190.        If you place a call using a telephone number (as opposed to
  4191.      calling via a nodelist), be sure to also set the BOSS parameter
  4192.      to the node number of the system you are calling, and PASSWORD
  4193.      to the correct password (or "") for that node. Here is an
  4194.      example: 
  4195.  
  4196.           TrapDoor Call 02236-87178 Boss 2:310/48 Password "" 
  4197.  
  4198.  
  4199.  
  4200.  
  4201.             "Remember, any minor imperfections in this product
  4202.               are just evidence of its hand crafted nature."
  4203.  
  4204.  
  4205.  
  4206.  
  4207.   8.1. Real Bugs    
  4208.  
  4209.        When sending in bug reports, please state exactly under what
  4210.      circumstances the bug occurred, what equipment was used and what
  4211.      happened. If possible, please give us a step-by-step description
  4212.      of how to reproduce the bug. Statements like "TrapDoor sometimes
  4213.      crashes on my system" don't help us to track down the problem.  
  4214.  
  4215.  
  4216.      Bugs?                              There are no bugs in our code.
  4217.  
  4218.  
  4219.      Page 69             TrapDoor's Fourth Manual              Page 69
  4220.  
  4221.  
  4222.   9. Past & Future   
  4223.  
  4224.        TrapDoor started back in spring 1989, when our boss got his
  4225.      first dual standard HST modem. Suddenly, BinkleyTerm Amiga
  4226.      stopped working, it could not successfully send/receive files.
  4227.      So mjl and I sat down and started writing a new mailer that
  4228.      would overcome this and many other disadvantages of BinkleyTerm
  4229.      Amiga, at that time the only mailer available for the Amiga.
  4230.      First, we created a point version; simple to use, it allowed you
  4231.      to setup a state-of-the-art point system. The point version was
  4232.      released in October 1989, and no major bugs have been found.
  4233.      That was version is 1.11; Registered users were shipped 1.12,
  4234.      which was almost the same, except the ShareWare reminders, which
  4235.      always open when you start the unregistered version, had been
  4236.      removed in that version.  
  4237.  
  4238.        After the enormous feedback we received from the first
  4239.      version, we decided we'd go ahead and make TrapDoor a fully
  4240.      node-capable mailer. We implemented the basic FidoNet protocol
  4241.      that all mailers must support, FTS-1, added ARexx capabilities,
  4242.      bbs spawning, nodelist support and all the other nice features
  4243.      noone wants to miss anymore. The first node capable version of
  4244.      TrapDoor 1.50, was followed by TrapDoor 1.80 a year later. This
  4245.      version enhanced the original node version with a couple of
  4246.      exciting new features: it offered new nodelist support via the
  4247.      traplist.library, improved ARexx commands, new bbs handling
  4248.      modes, special dialer and special node-dependent configuration
  4249.      options, EMSI session handshake, and lots more. As always, this
  4250.      node version could also be used in a point environment.  
  4251.  
  4252.        Unfortunately, a few annoying bugs had crept into version
  4253.      1.80. The program was working fine in the general case, but some
  4254.      points could not receive mail from their bosses. So we had to
  4255.      sit down and look into these problems. Still we included some
  4256.      more features in TrapDoor as they came in handy. So this is our
  4257.      fourth release version, and this number is also the reason for
  4258.      the name of this TrapDoor's manual.  
  4259.  
  4260.        Of course, development does not stop here. We will continue to
  4261.      improve TrapDoor and its related utilities to give you the
  4262.      hopefully most advanced mailer on the Amiga. Our future work
  4263.      will go especially in the direction of providing you with an
  4264.      integrated package which takes away a lot of the hassle
  4265.      currently involved in writing AmigaDOS or ARexx scripts to
  4266.      handle event scheduling and putting together the different tools
  4267.      necessary for a FidoNet system. Depending on your ShareWare
  4268.      registration efforts and our time permitting, one day there will
  4269.      hopefully be a much better and more beautiful TrapDoor II.  
  4270.  
  4271.        When this new and majorly improved TrapDoor becomes ready,
  4272.      already registered users will receive the new version for a
  4273.      moderate update fee.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.      Past & Future
  4279.  
  4280.  
  4281.      Page 70             TrapDoor's Fourth Manual              Page 70
  4282.  
  4283.  
  4284.   10. Registration     
  4285.  
  4286.        TrapDoor is a copyrighted product that has been made available
  4287.      to you under the concept of "Shareware". It has never been, nor
  4288.      will it ever be in the "Public Domain". You are granted a
  4289.      limited license in order to evaluate these programs. If, after a
  4290.      3 or 4 week period of evaluation, you find that TrapDoor suits
  4291.      your telecommunication needs, please register. By cooperating
  4292.      with this concept you help to ensure continued development of
  4293.      this product.  
  4294.  
  4295.        Registered users will be shipped a disk with the latest
  4296.      release version of TrapDoor together with a keyfile. This
  4297.      keyfile, once copied to your system, will disable the ShareWare
  4298.      reminders that always open when you start or quit TrapDoor.  
  4299.  
  4300.        Site license information for commercial and government use as
  4301.      well as source code licenses can be obtained directly from the
  4302.      authors.  
  4303.  
  4304.        No person(s) or businesses other than the authors are
  4305.      authorized to accept any registration or distribution fees in
  4306.      any form whatsoever, except the official registration and
  4307.      support centers as specified by the authors. The only people who
  4308.      will be acknowledged as registered users are those who have sent
  4309.      ATS 350,- (plus another ATS 150,- if you send foreign cheques or
  4310.      money orders) to: 
  4311.  
  4312.                            TrapDoor Development
  4313.                             Maximilian Hantsch
  4314.                       Matzleinsdorfer Platz 3-4/3/10
  4315.                                 A-1050 Wien
  4316.                              Austria / Europe
  4317.  
  4318.      or registered at one of the registration and support centers as
  4319.      specified by the authors. A list of these can be found in the
  4320.      file "SupportCenters.txt".  
  4321.  
  4322.        As one of the safest and possibly easiest ways to send in your
  4323.      registration fee from other countries, we would suggest an
  4324.      international postal money order -- your local post office will
  4325.      happily provide you with more information about this. It also
  4326.      has the advantage that the exchange of currencies is handled
  4327.      automatically and the surcharge is negligible.  
  4328.  
  4329.        Alternatively, you can either send us a Eurocheque payable to
  4330.      Maximilian Hantsch in Austrian Schillings or have your bank
  4331.      transfer the registration fee to the "Österreichische
  4332.      Postsparkasse (PSK)" (BLZ 60000), account 6.777.234, "Maximilian
  4333.      Hantsch". Beware: international transfers via banks are rather
  4334.      expensive.  
  4335.  
  4336.  
  4337.  
  4338.  
  4339.  
  4340.      Registration
  4341.  
  4342.  
  4343.      Page 71             TrapDoor's Fourth Manual              Page 71
  4344.  
  4345.  
  4346.        Note: IF YOU SEND CHEQUES, PLEASE SEND ONLY EUROCHEQUES MADE
  4347.      OUT IN AUSTRIAN SCHILLINGS! We have to impose a surcharge of ATS
  4348.      150,- on all other cheques, money orders or bank drafts.  
  4349.  
  4350.        Until now, we have accepted other foreign cheques, money
  4351.      orders and bank drafts as well, but our bank has raised the
  4352.      charge for these by more than 50% over the past two years to
  4353.      more than ATS 100,- per cheque. We can no longer afford this and
  4354.      are thus forced to pass on this charge. Sorry.  
  4355.  
  4356.        In any case, be sure to provide us with your name, address,
  4357.      fido-nodenumber and international phone number for our files.
  4358.      You can send this information via electronic mail, if you wish.
  4359.      If you don't mind, this data will be stored and processed in
  4360.      electronic form. There is also a sample registration form you
  4361.      can fill out in the file "Registration.txt".  
  4362.  
  4363.        Please allow up to eight weeks for delivery.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.  
  4379.  
  4380.  
  4381.                   You, too, can have a receding hairline,
  4382.                         suffer a nervous breakdown,
  4383.                 and precipitate disputes with your spouse.
  4384.                            Here is all you need.
  4385.  
  4386.  
  4387.  
  4388.  
  4389.  
  4390.  
  4391.  
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.      Registration
  4403.  
  4404.  
  4405.      Page 72             TrapDoor's Fourth Manual              Page 72
  4406.  
  4407.  
  4408.   11. Politics     
  4409.  
  4410.   11.1. Distribution     
  4411.  
  4412.        In a nutshell, TrapDoor may be distributed freely as long as
  4413.      the following restrictions are met: 
  4414.  
  4415.        The distributor may only charge a fee up to the costs of
  4416.      obtaining a public domain diskette from Fred Fish. The
  4417.      distributor agrees to cease distributing the programs and data
  4418.      involved if requested to do so by the authors. The distributor
  4419.      may only distribute an unmodified copy of the original program,
  4420.      with all the supplied documentation and copyright notices
  4421.      intact.  
  4422.  
  4423.        For more details, see the chapter called "License".  
  4424.  
  4425.  
  4426.  
  4427.   11.2. Support     
  4428.  
  4429.        The latest version of TrapDoor (with all its associated tools)
  4430.      is always available for filerequest from FidoNet node 2:310/6,
  4431.      "The Mad House" under the magic filename "TRAPDOOR".  
  4432.  
  4433.        If you have any suggestions, bug reports etc., feel free to
  4434.      contact the authors of TrapDoor at the address given in the
  4435.      chapter "Registration". Additionally, you can reach us at: 
  4436.  
  4437.           Maximilian Hantsch              Martin Laubach
  4438.           Fido:   2:310/6                 Fido:   2:310/3.14
  4439.           Uucp:   max@madvie.at           Uucp:   mjl@alison.at
  4440.  
  4441.        Also, there is a FidoNet Echomail conference called TRAPDOOR,
  4442.      which should be available at major backbones. This conference is
  4443.      in English and intended for the users of TrapDoor. There, you
  4444.      can freely exchange your experience with TrapDoor, discuss
  4445.      future enhancements you would like to see etc. Both authors will
  4446.      participate in the conference and try to assist you. The
  4447.      availability of new versions of TrapDoor will be announced
  4448.      there, too.  
  4449.  
  4450.  
  4451.  
  4452.   11.3. License     
  4453.  
  4454.        1. This license applies to the product called "TrapDoor", a
  4455.      set of programs for the Amiga computer, published by Maximilian
  4456.      Hantsch and Martin Laubach under the concepts of ShareWare, and
  4457.      the accompanying documentation, example files and anything else
  4458.      that comes with the original distribution. The terms "Programs"
  4459.      and "TrapDoor" below, refer to this product. The licensee is
  4460.      addressed as "you".  
  4461.  
  4462.  
  4463.  
  4464.      Politics                                              License
  4465.  
  4466.  
  4467.      Page 73             TrapDoor's Fourth Manual              Page 73
  4468.  
  4469.  
  4470.        2. You may copy and distribute verbatim copies of the
  4471.      programs' executable code and documentation as you receive it,
  4472.      in any medium, provided that you conspicuously and appropriately
  4473.      publish only the original, unmodified programs, with all
  4474.      copyright notices and disclaimers of warranty intact and
  4475.      including all the accompanying documentation, example files and
  4476.      anything else that came with the original.  
  4477.  
  4478.        3. You may not copy and/or distribute these programs without
  4479.      the accompanying documentation and other additional files that
  4480.      came with the original. You may not copy and/or distribute
  4481.      modified versions of these programs.  
  4482.  
  4483.        4. You may not copy, modify, sublicense, distribute or
  4484.      transfer the programs except as expressly provided under this
  4485.      license. Any attempt otherwise to copy, modify, sublicense,
  4486.      distribute or transfer the programs is void, and will
  4487.      automatically terminate your rights to use the programs under
  4488.      this license. However, parties who have received copies, or
  4489.      rights to use copies, from you under this license will not have
  4490.      their licenses terminated so long as such parties remain in full
  4491.      compliance.  
  4492.  
  4493.        5. By copying, distributing and/or using the programs you
  4494.      indicate your acceptance of this license to do so, and all its
  4495.      terms and conditions.  
  4496.  
  4497.        6. Each time you redistribute the programs, the recipient
  4498.      automatically receives a license from the original licensor to
  4499.      copy, distribute and/or use the programs subject to these terms
  4500.      and conditions.  You may not impose any further restrictions on
  4501.      the recipients' exercise of the rights granted herein.  
  4502.  
  4503.        7. You may not disassemble, decompile, re-source or otherwise
  4504.      reverse engineer the programs.  
  4505.  
  4506.        8. You may use the programs for a period of up to 30 days for
  4507.      evaluation.  After that, you have to register.  
  4508.  
  4509.        9. If you wish to incorporate parts of the programs into other
  4510.      programs, write to the authors to ask for permission.  
  4511.  
  4512.        10. You agree to cease distributing the programs and data
  4513.      involved if requested to do so by the authors.  
  4514.  
  4515.        11. You may charge a fee to recover distribution costs. The
  4516.      fee for diskette distribution may not be more than the cost to
  4517.      obtain a public domain diskette from Fred Fish.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.      Politics                                              License
  4527.  
  4528.  
  4529.      Page 74             TrapDoor's Fourth Manual              Page 74
  4530.  
  4531.  
  4532.   11.4. No Warranty    
  4533.  
  4534.        THERE IS NO WARRANTY FOR THE PROGRAMS, TO THE EXTENT PERMITTED
  4535.      BY APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE
  4536.      COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "AS
  4537.      IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
  4538.      INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  4539.      MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
  4540.      ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS
  4541.      WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU ASSUME THE
  4542.      COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.  
  4543.  
  4544.        IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  4545.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  4546.      REDISTRIBUTE THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO YOU
  4547.      FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  4548.      CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  4549.      THE PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
  4550.      BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  4551.      PARTIES OR A FAILURE OF THE PROGRAMS TO OPERATE WITH ANY OTHER
  4552.      PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED
  4553.      OF THE POSSIBILITY OF SUCH DAMAGES.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.   11.5. Disclaimer     
  4559.  
  4560.        No warranty, either express or implied, is made with respect
  4561.      to the fitness or merchantability of TrapDoor.  
  4562.  
  4563.        Maximilian Hantsch and Martin Laubach (referred to as "the
  4564.      authors"), reserve the right to not develop any future versions
  4565.      of TrapDoor.  
  4566.  
  4567.        The authors will try to make a good faith attempt at
  4568.      correcting any problems if any are discovered, but are in no way
  4569.      required, nor bound to correct them.  
  4570.  
  4571.        The authors neither assume nor accept any responsibility for
  4572.      the use or misuse of these programs. They also will not be held
  4573.      liable for damages or any compensation beyond the original
  4574.      registration fee due to loss of profit or any other damages
  4575.      arising out of the use, or inability to use these programs.  
  4576.  
  4577.        Neither Maximilian Hantsch nor Martin Laubach will be liable
  4578.      for any damage arising from the failure of these programs to
  4579.      perform as described, or any destruction of other programs or
  4580.      data residing on a system attempting to run the programs.  While
  4581.      we know of no damaging errors, the user of these programs uses
  4582.      it at his or her own risk.  
  4583.  
  4584.  
  4585.  
  4586.  
  4587.  
  4588.      Politics                                           Disclaimer
  4589.  
  4590.  
  4591.      Page 75             TrapDoor's Fourth Manual              Page 75
  4592.  
  4593.  
  4594.   12. Acknowledgements     
  4595.  
  4596.        The following names are either trademarks or the efforts of
  4597.      the person and/or company listed: 
  4598.  
  4599.        Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  4600.        ARexx by William S. Hawes, Wishful Thinking Development Corp.
  4601.        BinkleyTerm Amiga by Jürgen Hermann.
  4602.        BinkleyTerm by Alan D. Applegate, Robert Hartman
  4603.                       and Vincent Perriello.
  4604.        Chameleon Editor by Jürgen Hermann.
  4605.        ConfMail by Bob Hartman, Spark Software Inc.
  4606.        D'Bridge by Chris Irwin.
  4607.        Diamonds & Pearls by Prince
  4608.        DLG Professional by TelePro Technologies.
  4609.        EchoMail by Jeff Rush.
  4610.        EMSI by the EMSC.
  4611.        Falcon CBCS by Brian "I'm an IRCaholic" Fehdrau.
  4612.        FFSA by Carl-Christian Kanne.
  4613.        Fido and FidoNet are trademarks of Tom Jennings, Fido Software.
  4614.        FrontDoor by Joaquim Homrighausen.
  4615.        "Hey, there's Another Feature!"-Award: Roger Nordin.
  4616.        Inspiration by US Robotics' Dual HST.
  4617.        Jessi, our TrapBunny ;)
  4618.        License Agreement inspired by Jack Radigan
  4619.                       and the GNU General Public License.
  4620.        Many Thanks to Alexander Holy, Andreas Levenitschnig,
  4621.                       Arnout Grootveld, Café Heine, Felix Kasza,
  4622.                       Heiko Richter, Iljitsch van Beijnum, Johannes
  4623.                       Mistelbauer, Manfred Schädler, Many Others,
  4624.                       Marcus Kuba, Peer Hasselmeyer, Roger Nordin,
  4625.                       Tony Miller, Werner Schlagnitweit and Zteve Lewiz.
  4626.        Moral Support by MTNLION.
  4627.        More Moral Support from Tasmania.
  4628.        MS-DOS is a trademark of Microsoft Corporation.
  4629.        Opus by Wynn Wagner III.
  4630.        Paragon by Jon Radoff.
  4631.        Proofreading of this manual by Arnout Grootveld.
  4632.        SEAlink, SEAdog are trademarks of System Enhancement Associates.
  4633.        Spaces, Pigs, Ships and their Stars.
  4634.        Special Thanks to all our Registered Users.
  4635.        TrapDog by Peter Wlcek.
  4636.        TrapDoor is a registered trademark of Maximilian Hantsch
  4637.                                          and Martin Laubach.
  4638.        TrapList, TrapPoll, TrapTell and traplist.library
  4639.                       by Maximilian Hantsch and Martin Laubach.
  4640.        TrapToss by René Hexel.
  4641.        Typesetting of this manual by proff.
  4642.        YooHoo by Wynn Wagner III.
  4643.        ZModem by Chuck Forsberg.
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.      Acknowledgements
  4651.  
  4652.  
  4653.      Road Map            TrapDoor's Fourth Manual             paM daoR
  4654.  
  4655.  
  4656.   Road Map
  4657.  
  4658.  
  4659.         1. Introduction    .....................................    2
  4660.         2. Installation    .....................................    2
  4661.            2.1. The Keyfile   ..................................    3
  4662.            2.2. Point Setup   ..................................    3
  4663.            2.3. Node Setup   ...................................    4
  4664.            2.4. The Modem   ....................................    5
  4665.            2.5. Example Modem Settings  ........................    6
  4666.               2.5.1. US Robotics Courier HST Modems.............    6
  4667.               2.5.2. Ordinary 2400 Baud Modems .................    7
  4668.               2.5.3. Internal Supra 2400zi Modems ..............    8
  4669.               2.5.4. Supra V.32bis   ...........................    8
  4670.               2.5.5. ZyXEL Modems   ............................    9
  4671.         3. Basics    ...........................................   10
  4672.            3.1. FidoNet    .....................................   10
  4673.            3.2. Mailer Operation   .............................   10
  4674.            3.3. Nodelist    ....................................   10
  4675.            3.4. Compatibility    ...............................   10
  4676.            3.5. Custom Configuration Entries  ..................   11
  4677.            3.6. Accounting    ..................................   12
  4678.            3.7. Security    ....................................   13
  4679.            3.8. File Tagging   .................................   13
  4680.            3.9. Refusing and Pickup Preferences ................   14
  4681.            3.10. The Keyboard   ................................   14
  4682.            3.11. Return Values   ...............................   16
  4683.            3.12. ARexx    ......................................   17
  4684.            3.13. Dial Scripts   ................................   18
  4685.            3.14. Multiple Lines   ..............................   19
  4686.            3.15. Logfile Buffering   ...........................   21
  4687.            3.16. Automatic Buffer Sizing  ......................   21
  4688.            3.17. Fax Support   .................................   21
  4689.         4. Configuration Commands   ............................   22
  4690.            4.1. Embedded Percent-Commands   ....................   23
  4691.            4.2. Modem Commands   ...............................   24
  4692.            4.3. Keywords    ....................................   25
  4693.               4.3.1. (NO)7WIRE    ..............................   25
  4694.               4.3.2. ABORT signals   ...........................   25
  4695.               4.3.3. (NO)ABS    ................................   25
  4696.               4.3.4. (NO)ACCOUNTING    .........................   25
  4697.               4.3.5. ACCTMAX limits   ..........................   25
  4698.               4.3.6. ADJUST factor   ...........................   26
  4699.               4.3.7. AFTERSESSION command-string   .............   27
  4700.               4.3.8. AKA akalist   .............................   27
  4701.               4.3.9. (NO)ALLOWREFUSING    ......................   27
  4702.               4.3.10. ANSWER    ................................   27
  4703.               4.3.11. ARQSTRING string   .......................   28
  4704.               4.3.12. (NO)AUTOADJUST    ........................   28
  4705.               4.3.13. (NO)AUTOOVERSCAN    ......................   28
  4706.               4.3.14. (NO)BACKGROUND    ........................   28
  4707.               4.3.15. BANNER bannerline   ......................   28
  4708.               4.3.16. BAUD baudrate   ..........................   29
  4709.               4.3.17. BBSCHAR character   ......................   29
  4710.  
  4711.  
  4712.      Road Map
  4713.  
  4714.  
  4715.      Road Map            TrapDoor's Fourth Manual             paM daoR
  4716.  
  4717.  
  4718.               4.3.18. BBSCOMMAND command-string   ..............   29
  4719.               4.3.19. BBSINOUT device   ........................   29
  4720.               4.3.20. BBSMESSAGE text   ........................   30
  4721.               4.3.21. BBSMODE mode   ...........................   30
  4722.               4.3.22. (NO)BEEPDISPLAY    .......................   31
  4723.               4.3.23. BOSS zone:net/node.point   ...............   31
  4724.               4.3.24. CALL number | fido-address ...............   31
  4725.               4.3.25. COLORS palette-specification   ...........   32
  4726.               4.3.26. COLOURS palette-specification   ..........   32
  4727.               4.3.27. CONCEPTS    ..............................   33
  4728.               4.3.28. CONFIG config-file   .....................   33
  4729.               4.3.29. COST    ..................................   33
  4730.               4.3.30. CREDITS    ...............................   33
  4731.               4.3.31. DIALER command-string   ..................   34
  4732.               4.3.32. (NO)DIETIFNA    ..........................   34
  4733.               4.3.33. (NO)DIRECTZAP    .........................   34
  4734.               4.3.34. DROPBBSSECS seconds   ....................   34
  4735.               4.3.35. (NO)DSR    ...............................   35
  4736.               4.3.36. (NO)EMSI    ..............................   35
  4737.               4.3.37. (NO)FASTEMSI    ..........................   35
  4738.               4.3.38. FAXCOMMAND commandline   .................   36
  4739.               4.3.39. FAXSTRING string   .......................   36
  4740.               4.3.40. FKEY function-key-assignment   ...........   36
  4741.               4.3.41. (NO)FLOATLOCK    .........................   37
  4742.               4.3.42. (NO)FORBID...    .........................   37
  4743.               4.3.43. FREQUEST command-string   ................   37
  4744.               4.3.44. HELP    ..................................   38
  4745.               4.3.45. (NO)IMMEDIATE    .........................   38
  4746.               4.3.46. INBOUND inbound-mail-directory   .........   38
  4747.               4.3.47. (NO)INTERLACE    .........................   39
  4748.               4.3.48. (NO)KIWIPULSE    .........................   39
  4749.               4.3.49. (NO)LOCK    ..............................   39
  4750.               4.3.50. LOG level:text   .........................   39
  4751.               4.3.51. LOGFILE filename   .......................   39
  4752.               4.3.52. LOGLEVEL group:level   ...................   40
  4753.               4.3.53. LOGWINDOW window-specification   .........   40
  4754.               4.3.54. (NO)MAXBAUD    ...........................   41
  4755.               4.3.55. MAXLOGLINES number   .....................   41
  4756.               4.3.56. MAXLOGSECS seconds   .....................   42
  4757.               4.3.57. MINBAUD baudrate   .......................   42
  4758.               4.3.58. MODEMANSWER modem-answer-string   ........   42
  4759.               4.3.59. MODEMDIALPRE modem-pre-dial-string   .....   42
  4760.               4.3.60. MODEMDIALPOST modem-post-dial-string   ...   42
  4761.               4.3.61. MODEMHANGUP modem-hangup-string   ........   43
  4762.               4.3.62. MODEMINIT modem-init-string   ............   43
  4763.               4.3.63. NAME board's name  .......................   43
  4764.               4.3.64. NODE zone:net/node.point   ...............   43
  4765.               4.3.65. NODELIST nodelist-directory   ............   44
  4766.               4.3.66. OUTBOUND outbound-mail-directory   .......   44
  4767.               4.3.67. PASSWORD password   ......................   44
  4768.               4.3.68. PICKUP what   ............................   45
  4769.               4.3.69. PUBSCREENNAME name   .....................   45
  4770.               4.3.70. QUIT    ..................................   45
  4771.               4.3.71. (NO)QUIET    .............................   46
  4772.  
  4773.  
  4774.      Road Map
  4775.  
  4776.  
  4777.      Road Map            TrapDoor's Fourth Manual             paM daoR
  4778.  
  4779.  
  4780.               4.3.72. REDIALDELAY seconds   ....................   46
  4781.               4.3.73. RESET    .................................   46
  4782.               4.3.74. RETRIES count   ..........................   46
  4783.               4.3.75. REXXNAME portname   ......................   46
  4784.               4.3.76. RINGCOMMAND commandline   ................   47
  4785.               4.3.77. RINGINGS number   ........................   47
  4786.               4.3.78. RINGS number   ...........................   47
  4787.               4.3.79. RUN command-string   .....................   47
  4788.               4.3.80. SCLEAR    ................................   48
  4789.               4.3.81. SCREENMODE mode   ........................   48
  4790.               4.3.82. SERIALFLAGS serial-flags   ...............   49
  4791.               4.3.83. SERIALNAME serial-device-name   ..........   49
  4792.               4.3.84. SERIALUNIT serial-unit-number   ..........   49
  4793.               4.3.85. (NO)SHARED    ............................   49
  4794.               4.3.86. (NO)SHOWREXX    ..........................   49
  4795.               4.3.87. SLINE    .................................   49
  4796.               4.3.88. SLOWMODEM modem-command-delay   ..........   50
  4797.               4.3.89. SMODEM modem-command   ...................   50
  4798.               4.3.90. (NO)SNIFFARQ    ..........................   50
  4799.               4.3.91. SPAWN command-string   ...................   51
  4800.               4.3.92. STARTSESSION    ..........................   51
  4801.               4.3.93. STATUS what   ............................   51
  4802.               4.3.94. STATWINDOW window-specification   ........   52
  4803.               4.3.95. STIMEOUT timeout   .......................   52
  4804.               4.3.96. SWAIT string   ...........................   52
  4805.               4.3.97. (NO)SWEPULSE    ..........................   53
  4806.               4.3.98. SWRITE string   ..........................   53
  4807.               4.3.99. SYSOP sysop's-name   .....................   53
  4808.               4.3.100. TASKPRI priority   ......................   53
  4809.               4.3.101. TESTFREQ    .............................   53
  4810.               4.3.102. (NO)TIMESTAMP    ........................   54
  4811.               4.3.103. (NO)UNLISTEN    .........................   54
  4812.               4.3.104. (NO)WAZOO    ............................   54
  4813.               4.3.105. (NO)WRAPLINES    ........................   54
  4814.               4.3.106. (NO)XMAIL    ............................   55
  4815.               4.3.107. (NO)ZEDZAP    ...........................   55
  4816.               4.3.108. (NO)ZEDZIP    ...........................   55
  4817.         5. Example Setup   .....................................   56
  4818.         6. The Outbound Directory  .............................   62
  4819.            6.1. 'Compatibility' Filenames   ....................   62
  4820.            6.2. 4-dimensional Filenames   ......................   62
  4821.            6.3. Extensions    ..................................   62
  4822.            6.4. Packet files   .................................   62
  4823.            6.5. Flow files   ...................................   63
  4824.            6.6. Compressed Mail files  .........................   63
  4825.            6.7. Request files   ................................   64
  4826.            6.8. Examples    ....................................   64
  4827.         7. The Inbound Directory  ..............................   65
  4828.            7.1. Bumping Filenames   ............................   67
  4829.         8. Bugs? Poof! They're all features!....................   68
  4830.            8.1. Real Bugs   ....................................   68
  4831.         9. Past & Future  ......................................   69
  4832.         10. Registration    ....................................   70
  4833.         11. Politics    ........................................   72
  4834.  
  4835.  
  4836.      Road Map
  4837.  
  4838.  
  4839.      Road Map            TrapDoor's Fourth Manual             paM daoR
  4840.  
  4841.  
  4842.            11.1. Distribution    ...............................   72
  4843.            11.2. Support    ....................................   72
  4844.            11.3. License    ....................................   72
  4845.            11.4. No Warranty   .................................   74
  4846.            11.5. Disclaimer    .................................   74
  4847.         12. Acknowledgements    ................................   75
  4848.  
  4849.  
  4850.  
  4851.  
  4852.  
  4853.  
  4854.  
  4855.  
  4856.  
  4857.  
  4858.  
  4859.  
  4860.  
  4861.  
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.             "And you try to tell that the young people of today
  4869.                        and they won't believe you."
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.      Road Map
  4899.  
  4900.